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 blink { 32 33 // Attr can have Text children 34 // therefore it has to be a fullblown Node. The plan 35 // is to dynamically allocate a textchild and store the 36 // resulting nodevalue in the attribute upon 37 // destruction. however, this is not yet implemented. 38 39 class Attr FINAL : public ContainerNode { 40 DEFINE_WRAPPERTYPEINFO(); 41 public: 42 static PassRefPtrWillBeRawPtr<Attr> create(Element&, const QualifiedName&); 43 static PassRefPtrWillBeRawPtr<Attr> create(Document&, const QualifiedName&, const AtomicString& value); 44 virtual ~Attr(); 45 46 String name() const { return m_name.toString(); } 47 bool specified() const { return true; } 48 Element* ownerElement() const { return m_element; } 49 50 const AtomicString& value() const; 51 void setValue(const AtomicString&); 52 53 const AtomicString& valueForBindings() const; 54 void setValueForBindings(const AtomicString&); 55 56 const QualifiedName qualifiedName() const; 57 58 void attachToElement(Element*, const AtomicString&); 59 void detachFromElementWithValue(const AtomicString&); 60 61 virtual const AtomicString& localName() const OVERRIDE { return m_name.localName(); } 62 virtual const AtomicString& namespaceURI() const OVERRIDE { return m_name.namespaceURI(); } 63 const AtomicString& prefix() const { return m_name.prefix(); } 64 65 virtual void trace(Visitor*) OVERRIDE; 66 67 private: 68 Attr(Element&, const QualifiedName&); 69 Attr(Document&, const QualifiedName&, const AtomicString& value); 70 71 bool isElementNode() const WTF_DELETED_FUNCTION; // This will catch anyone doing an unnecessary check. 72 73 void createTextChild(); 74 75 void setValueInternal(const AtomicString&); 76 77 virtual String nodeName() const OVERRIDE { return name(); } 78 virtual NodeType nodeType() const OVERRIDE { return ATTRIBUTE_NODE; } 79 80 virtual String nodeValue() const OVERRIDE { return value(); } 81 virtual void setNodeValue(const String&) OVERRIDE; 82 virtual PassRefPtrWillBeRawPtr<Node> cloneNode(bool deep = true) OVERRIDE; 83 84 virtual bool isAttributeNode() const OVERRIDE { return true; } 85 virtual bool childTypeAllowed(NodeType) const OVERRIDE; 86 87 virtual void childrenChanged(const ChildrenChange&) OVERRIDE; 88 89 Attribute& elementAttribute(); 90 91 // Attr wraps either an element/name, or a name/value pair (when it's a standalone Node.) 92 // Note that m_name is always set, but m_element/m_standaloneValue may be null. 93 RawPtrWillBeMember<Element> m_element; 94 QualifiedName m_name; 95 // Holds the value if it is a standalone Node, or the local name of the 96 // attribute it is attached to on an Element. The latter may (letter case) 97 // differ from m_name's local name. As these two modes are non-overlapping, 98 // use a single field. 99 AtomicString m_standaloneValueOrAttachedLocalName; 100 unsigned m_ignoreChildrenChanged; 101 }; 102 103 DEFINE_NODE_TYPE_CASTS(Attr, isAttributeNode()); 104 105 } // namespace blink 106 107 #endif // Attr_h 108
