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, 2007, 2008, 2009 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 Attr_h
     26 #define Attr_h
     27 
     28 #include "core/dom/ContainerNode.h"
     29 #include "core/dom/QualifiedName.h"
     30 
     31 namespace WebCore {
     32 
     33 class CSSStyleDeclaration;
     34 class ExceptionState;
     35 class MutableStylePropertySet;
     36 
     37 // Attr can have Text children
     38 // therefore it has to be a fullblown Node. The plan
     39 // is to dynamically allocate a textchild and store the
     40 // resulting nodevalue in the attribute upon
     41 // destruction. however, this is not yet implemented.
     42 
     43 class Attr FINAL : public ContainerNode {
     44 public:
     45     static PassRefPtr<Attr> create(Element*, const QualifiedName&);
     46     static PassRefPtr<Attr> create(Document*, const QualifiedName&, const AtomicString& value);
     47     virtual ~Attr();
     48 
     49     String name() const { return qualifiedName().toString(); }
     50     bool specified() const { return m_specified; }
     51     Element* ownerElement() const { return m_element; }
     52 
     53     const AtomicString& value() const;
     54     void setValue(const AtomicString&, ExceptionState&);
     55     void setValue(const AtomicString&);
     56 
     57     const QualifiedName& qualifiedName() const { return m_name; }
     58 
     59     bool isId() const;
     60 
     61     void setSpecified(bool specified) { m_specified = specified; }
     62 
     63     void attachToElement(Element*);
     64     void detachFromElementWithValue(const AtomicString&);
     65 
     66 private:
     67     Attr(Element*, const QualifiedName&);
     68     Attr(Document*, const QualifiedName&, const AtomicString& value);
     69 
     70     void createTextChild();
     71 
     72     virtual String nodeName() const OVERRIDE { return name(); }
     73     virtual NodeType nodeType() const OVERRIDE { return ATTRIBUTE_NODE; }
     74 
     75     virtual const AtomicString& localName() const OVERRIDE { return m_name.localName(); }
     76     virtual const AtomicString& namespaceURI() const OVERRIDE { return m_name.namespaceURI(); }
     77     virtual const AtomicString& prefix() const OVERRIDE { return m_name.prefix(); }
     78 
     79     virtual void setPrefix(const AtomicString&, ExceptionState&);
     80 
     81     virtual String nodeValue() const OVERRIDE { return value(); }
     82     virtual void setNodeValue(const String&);
     83     virtual PassRefPtr<Node> cloneNode(bool deep = true);
     84 
     85     virtual bool isAttributeNode() const { return true; }
     86     virtual bool childTypeAllowed(NodeType) const;
     87 
     88     virtual void childrenChanged(bool changedByParser = false, Node* beforeChange = 0, Node* afterChange = 0, int childCountDelta = 0);
     89 
     90     Attribute& elementAttribute();
     91 
     92     // Attr wraps either an element/name, or a name/value pair (when it's a standalone Node.)
     93     // Note that m_name is always set, but m_element/m_standaloneValue may be null.
     94     Element* m_element;
     95     QualifiedName m_name;
     96     AtomicString m_standaloneValue;
     97 
     98     unsigned m_ignoreChildrenChanged : 31;
     99     bool m_specified : 1;
    100 };
    101 
    102 inline Attr* toAttr(Node* node)
    103 {
    104     ASSERT_WITH_SECURITY_IMPLICATION(!node || node->isAttributeNode());
    105     return static_cast<Attr*>(node);
    106 }
    107 
    108 inline const Attr* toAttr(const Node* node)
    109 {
    110     ASSERT_WITH_SECURITY_IMPLICATION(!node || node->isAttributeNode());
    111     return static_cast<const Attr*>(node);
    112 }
    113 
    114 } // namespace WebCore
    115 
    116 #endif // Attr_h
    117