Home | History | Annotate | Download | only in dom 
      1 /*
      2  * Copyright (C) 1999 Lars Knoll (knoll (at) kde.org)
      3  *           (C) 1999 Antti Koivisto (koivisto (at) kde.org)
      4  *           (C) 2001 Peter Kelly (pmk (at) post.com)
      5  *           (C) 2001 Dirk Mueller (mueller (at) kde.org)
      6  * Copyright (C) 2003, 2004, 2005, 2006, 2008, 2012 Apple Inc. All rights reserved.
      7  *
      8  * This library is free software; you can redistribute it and/or
      9  * modify it under the terms of the GNU Library General Public
     10  * License as published by the Free Software Foundation; either
     11  * version 2 of the License, or (at your option) any later version.
     12  *
     13  * This library is distributed in the hope that it will be useful,
     14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
     15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
     16  * Library General Public License for more details.
     17  *
     18  * You should have received a copy of the GNU Library General Public License
     19  * along with this library; see the file COPYING.LIB.  If not, write to
     20  * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
     21  * Boston, MA 02110-1301, USA.
     22  *
     23  */
     24 
     25 #ifndef Attribute_h
     26 #define Attribute_h
     27 
     28 #include "core/dom/QualifiedName.h"
     29 
     30 namespace blink {
     31 
     32 // This has no counterpart in DOM.
     33 // It is an internal representation of the node value of an Attr.
     34 // The actual Attr with its value as a Text child is allocated only if needed.
     35 class Attribute {
     36 public:
     37     Attribute(const QualifiedName& name, const AtomicString& value)
     38         : m_name(name)
     39         , m_value(value)
     40     {
     41     }
     42 
     43     // NOTE: The references returned by these functions are only valid for as long
     44     // as the Attribute stays in place. For example, calling a function that mutates
     45     // an Element's internal attribute storage may invalidate them.
     46     const AtomicString& value() const { return m_value; }
     47     const AtomicString& prefix() const { return m_name.prefix(); }
     48     const AtomicString& localName() const { return m_name.localName(); }
     49     const AtomicString& namespaceURI() const { return m_name.namespaceURI(); }
     50 
     51     const QualifiedName& name() const { return m_name; }
     52 
     53     bool isEmpty() const { return m_value.isEmpty(); }
     54     bool matches(const QualifiedName&) const;
     55 
     56     void setValue(const AtomicString& value) { m_value = value; }
     57     void setPrefix(const AtomicString& prefix) { m_name.setPrefix(prefix); }
     58 
     59     // Note: This API is only for HTMLTreeBuilder.  It is not safe to change the
     60     // name of an attribute once parseAttribute has been called as DOM
     61     // elements may have placed the Attribute in a hash by name.
     62     void parserSetName(const QualifiedName& name) { m_name = name; }
     63 
     64 #if COMPILER(MSVC)
     65     // NOTE: This constructor is not actually implemented, it's just defined so MSVC
     66     // will let us use a zero-length array of Attributes.
     67     Attribute();
     68 #endif
     69 
     70 private:
     71     QualifiedName m_name;
     72     AtomicString m_value;
     73 };
     74 
     75 inline bool Attribute::matches(const QualifiedName& qualifiedName) const
     76 {
     77     if (qualifiedName.localName() != localName())
     78         return false;
     79     return qualifiedName.prefix() == starAtom || qualifiedName.namespaceURI() == namespaceURI();
     80 }
     81 
     82 } // namespace blink
     83 
     84 #endif // Attribute_h
     85