Changing id, className, or attribute should invalidate distribution
[WebKit-https.git] / Source / WebCore / dom / Element.h
1 /*
2  * Copyright (C) 1999 Lars Knoll (knoll@kde.org)
3  *           (C) 1999 Antti Koivisto (koivisto@kde.org)
4  *           (C) 2001 Peter Kelly (pmk@post.com)
5  *           (C) 2001 Dirk Mueller (mueller@kde.org)
6  * Copyright (C) 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 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 Element_h
26 #define Element_h
27
28 #include "CollectionType.h"
29 #include "Document.h"
30 #include "ElementAttributeData.h"
31 #include "FragmentScriptingPermission.h"
32 #include "HTMLNames.h"
33 #include "ScrollTypes.h"
34
35 namespace WebCore {
36
37 class Attribute;
38 class ClientRect;
39 class ClientRectList;
40 class DOMStringMap;
41 class DOMTokenList;
42 class ElementRareData;
43 class ElementShadow;
44 class IntSize;
45 class Locale;
46 class RenderRegion;
47 class ShadowRoot;
48 class WebKitAnimationList;
49
50 enum SpellcheckAttributeState {
51     SpellcheckAttributeTrue,
52     SpellcheckAttributeFalse,
53     SpellcheckAttributeDefault
54 };
55
56 class Element : public ContainerNode {
57 public:
58     static PassRefPtr<Element> create(const QualifiedName&, Document*);
59     virtual ~Element();
60
61     DEFINE_ATTRIBUTE_EVENT_LISTENER(abort);
62     DEFINE_ATTRIBUTE_EVENT_LISTENER(change);
63     DEFINE_ATTRIBUTE_EVENT_LISTENER(click);
64     DEFINE_ATTRIBUTE_EVENT_LISTENER(contextmenu);
65     DEFINE_ATTRIBUTE_EVENT_LISTENER(dblclick);
66     DEFINE_ATTRIBUTE_EVENT_LISTENER(dragenter);
67     DEFINE_ATTRIBUTE_EVENT_LISTENER(dragover);
68     DEFINE_ATTRIBUTE_EVENT_LISTENER(dragleave);
69     DEFINE_ATTRIBUTE_EVENT_LISTENER(drop);
70     DEFINE_ATTRIBUTE_EVENT_LISTENER(dragstart);
71     DEFINE_ATTRIBUTE_EVENT_LISTENER(drag);
72     DEFINE_ATTRIBUTE_EVENT_LISTENER(dragend);
73     DEFINE_ATTRIBUTE_EVENT_LISTENER(input);
74     DEFINE_ATTRIBUTE_EVENT_LISTENER(invalid);
75     DEFINE_ATTRIBUTE_EVENT_LISTENER(keydown);
76     DEFINE_ATTRIBUTE_EVENT_LISTENER(keypress);
77     DEFINE_ATTRIBUTE_EVENT_LISTENER(keyup);
78     DEFINE_ATTRIBUTE_EVENT_LISTENER(mousedown);
79     DEFINE_ATTRIBUTE_EVENT_LISTENER(mousemove);
80     DEFINE_ATTRIBUTE_EVENT_LISTENER(mouseout);
81     DEFINE_ATTRIBUTE_EVENT_LISTENER(mouseover);
82     DEFINE_ATTRIBUTE_EVENT_LISTENER(mouseup);
83     DEFINE_ATTRIBUTE_EVENT_LISTENER(mousewheel);
84     DEFINE_ATTRIBUTE_EVENT_LISTENER(scroll);
85     DEFINE_ATTRIBUTE_EVENT_LISTENER(select);
86     DEFINE_ATTRIBUTE_EVENT_LISTENER(submit);
87
88     // These four attribute event handler attributes are overridden by HTMLBodyElement
89     // and HTMLFrameSetElement to forward to the DOMWindow.
90     DECLARE_VIRTUAL_ATTRIBUTE_EVENT_LISTENER(blur);
91     DECLARE_VIRTUAL_ATTRIBUTE_EVENT_LISTENER(error);
92     DECLARE_VIRTUAL_ATTRIBUTE_EVENT_LISTENER(focus);
93     DECLARE_VIRTUAL_ATTRIBUTE_EVENT_LISTENER(load);
94
95     // WebKit extensions
96     DEFINE_ATTRIBUTE_EVENT_LISTENER(beforecut);
97     DEFINE_ATTRIBUTE_EVENT_LISTENER(cut);
98     DEFINE_ATTRIBUTE_EVENT_LISTENER(beforecopy);
99     DEFINE_ATTRIBUTE_EVENT_LISTENER(copy);
100     DEFINE_ATTRIBUTE_EVENT_LISTENER(beforepaste);
101     DEFINE_ATTRIBUTE_EVENT_LISTENER(paste);
102     DEFINE_ATTRIBUTE_EVENT_LISTENER(reset);
103     DEFINE_ATTRIBUTE_EVENT_LISTENER(search);
104     DEFINE_ATTRIBUTE_EVENT_LISTENER(selectstart);
105 #if ENABLE(TOUCH_EVENTS)
106     DEFINE_ATTRIBUTE_EVENT_LISTENER(touchstart);
107     DEFINE_ATTRIBUTE_EVENT_LISTENER(touchmove);
108     DEFINE_ATTRIBUTE_EVENT_LISTENER(touchend);
109     DEFINE_ATTRIBUTE_EVENT_LISTENER(touchcancel);
110 #endif
111 #if ENABLE(FULLSCREEN_API)
112     DEFINE_ATTRIBUTE_EVENT_LISTENER(webkitfullscreenchange);
113     DEFINE_ATTRIBUTE_EVENT_LISTENER(webkitfullscreenerror);
114 #endif
115
116     bool hasAttribute(const QualifiedName&) const;
117     const AtomicString& getAttribute(const QualifiedName&) const;
118     void setAttribute(const QualifiedName&, const AtomicString& value);
119     void setSynchronizedLazyAttribute(const QualifiedName&, const AtomicString& value);
120     void removeAttribute(const QualifiedName&);
121
122     // Typed getters and setters for language bindings.
123     int getIntegralAttribute(const QualifiedName& attributeName) const;
124     void setIntegralAttribute(const QualifiedName& attributeName, int value);
125     unsigned getUnsignedIntegralAttribute(const QualifiedName& attributeName) const;
126     void setUnsignedIntegralAttribute(const QualifiedName& attributeName, unsigned value);
127
128     // Call this to get the value of an attribute that is known not to be the style
129     // attribute or one of the SVG animatable attributes.
130     bool fastHasAttribute(const QualifiedName&) const;
131     const AtomicString& fastGetAttribute(const QualifiedName&) const;
132 #ifndef NDEBUG
133     bool fastAttributeLookupAllowed(const QualifiedName&) const;
134 #endif
135
136 #ifdef DUMP_NODE_STATISTICS
137     bool hasNamedNodeMap() const;
138 #endif
139     bool hasAttributes() const;
140     // This variant will not update the potentially invalid attributes. To be used when not interested
141     // in style attribute or one of the SVG animation attributes.
142     bool hasAttributesWithoutUpdate() const;
143
144     bool hasAttribute(const AtomicString& name) const;
145     bool hasAttributeNS(const AtomicString& namespaceURI, const AtomicString& localName) const;
146
147     const AtomicString& getAttribute(const AtomicString& name) const;
148     const AtomicString& getAttributeNS(const AtomicString& namespaceURI, const AtomicString& localName) const;
149
150     void setAttribute(const AtomicString& name, const AtomicString& value, ExceptionCode&);
151     static bool parseAttributeName(QualifiedName&, const AtomicString& namespaceURI, const AtomicString& qualifiedName, ExceptionCode&);
152     void setAttributeNS(const AtomicString& namespaceURI, const AtomicString& qualifiedName, const AtomicString& value, ExceptionCode&);
153
154     bool isIdAttributeName(const QualifiedName&) const;
155     const AtomicString& getIdAttribute() const;
156     void setIdAttribute(const AtomicString&);
157
158     const AtomicString& getNameAttribute() const;
159
160     // Call this to get the value of the id attribute for style resolution purposes.
161     // The value will already be lowercased if the document is in compatibility mode,
162     // so this function is not suitable for non-style uses.
163     const AtomicString& idForStyleResolution() const;
164
165     // Internal methods that assume the existence of attribute storage, one should use hasAttributes()
166     // before calling them.
167     size_t attributeCount() const;
168     const Attribute* attributeItem(unsigned index) const;
169     const Attribute* getAttributeItem(const QualifiedName&) const;
170     Attribute* getAttributeItem(const QualifiedName&);
171     size_t getAttributeItemIndex(const QualifiedName& name) const { return attributeData()->getAttributeItemIndex(name); }
172     size_t getAttributeItemIndex(const AtomicString& name, bool shouldIgnoreAttributeCase) const { return attributeData()->getAttributeItemIndex(name, shouldIgnoreAttributeCase); }
173
174     void scrollIntoView(bool alignToTop = true);
175     void scrollIntoViewIfNeeded(bool centerIfNeeded = true);
176
177     void scrollByLines(int lines);
178     void scrollByPages(int pages);
179
180     int offsetLeft();
181     int offsetTop();
182     int offsetWidth();
183     int offsetHeight();
184     Element* offsetParent();
185     int clientLeft();
186     int clientTop();
187     int clientWidth();
188     int clientHeight();
189     virtual int scrollLeft();
190     virtual int scrollTop();
191     virtual void setScrollLeft(int);
192     virtual void setScrollTop(int);
193     virtual int scrollWidth();
194     virtual int scrollHeight();
195
196     IntRect boundsInRootViewSpace();
197
198     PassRefPtr<ClientRectList> getClientRects();
199     PassRefPtr<ClientRect> getBoundingClientRect();
200     
201     // Returns the absolute bounding box translated into screen coordinates:
202     IntRect screenRect() const;
203
204     void removeAttribute(const AtomicString& name);
205     void removeAttributeNS(const AtomicString& namespaceURI, const AtomicString& localName);
206
207     PassRefPtr<Attr> detachAttribute(size_t index);
208
209     PassRefPtr<Attr> getAttributeNode(const AtomicString& name);
210     PassRefPtr<Attr> getAttributeNodeNS(const AtomicString& namespaceURI, const AtomicString& localName);
211     PassRefPtr<Attr> setAttributeNode(Attr*, ExceptionCode&);
212     PassRefPtr<Attr> setAttributeNodeNS(Attr*, ExceptionCode&);
213     PassRefPtr<Attr> removeAttributeNode(Attr*, ExceptionCode&);
214
215     PassRefPtr<Attr> attrIfExists(const QualifiedName&);
216     PassRefPtr<Attr> ensureAttr(const QualifiedName&);
217     
218     virtual CSSStyleDeclaration* style();
219
220     const QualifiedName& tagQName() const { return m_tagName; }
221     String tagName() const { return nodeName(); }
222     bool hasTagName(const QualifiedName& tagName) const { return m_tagName.matches(tagName); }
223     
224     // A fast function for checking the local name against another atomic string.
225     bool hasLocalName(const AtomicString& other) const { return m_tagName.localName() == other; }
226     bool hasLocalName(const QualifiedName& other) const { return m_tagName.localName() == other.localName(); }
227
228     const AtomicString& localName() const { return m_tagName.localName(); }
229     const AtomicString& prefix() const { return m_tagName.prefix(); }
230     const AtomicString& namespaceURI() const { return m_tagName.namespaceURI(); }
231
232     virtual KURL baseURI() const;
233
234     virtual String nodeName() const;
235
236     PassRefPtr<Element> cloneElementWithChildren();
237     PassRefPtr<Element> cloneElementWithoutChildren();
238
239     void normalizeAttributes();
240     String nodeNamePreservingCase() const;
241
242     void setBooleanAttribute(const QualifiedName& name, bool);
243
244     // For exposing to DOM only.
245     NamedNodeMap* attributes() const;
246
247     // This method is called whenever an attribute is added, changed or removed.
248     virtual void attributeChanged(const QualifiedName&, const AtomicString&);
249     virtual void parseAttribute(const QualifiedName&, const AtomicString&) { }
250
251     // Only called by the parser immediately after element construction.
252     void parserSetAttributes(const Vector<Attribute>&, FragmentScriptingPermission);
253
254     const ElementAttributeData* attributeData() const { return m_attributeData.get(); }
255     ElementAttributeData* mutableAttributeData();
256     const ElementAttributeData* ensureAttributeData();
257     const ElementAttributeData* updatedAttributeData() const;
258     const ElementAttributeData* ensureUpdatedAttributeData() const;
259
260     // Clones attributes only.
261     void cloneAttributesFromElement(const Element&);
262
263     // Clones all attribute-derived data, including subclass specifics (through copyNonAttributeProperties.)
264     void cloneDataFromElement(const Element&);
265
266     bool hasEquivalentAttributes(const Element* other) const;
267
268     virtual void copyNonAttributePropertiesFromElement(const Element&) { }
269
270     virtual void attach();
271     virtual void detach();
272     virtual RenderObject* createRenderer(RenderArena*, RenderStyle*);
273     void recalcStyle(StyleChange = NoChange);
274
275     ElementShadow* shadow() const;
276     ElementShadow* ensureShadow();
277     virtual void willAddAuthorShadowRoot() { }
278     virtual bool areAuthorShadowsAllowed() const { return true; }
279
280     ShadowRoot* userAgentShadowRoot() const;
281
282     virtual const AtomicString& shadowPseudoId() const;
283
284     RenderStyle* computedStyle(PseudoId = NOPSEUDO);
285
286     void setStyleAffectedByEmpty();
287     bool styleAffectedByEmpty() const;
288
289     void setIsInCanvasSubtree(bool);
290     bool isInCanvasSubtree() const;
291
292     AtomicString computeInheritedLanguage() const;
293     Locale& locale() const;
294
295     virtual void accessKeyAction(bool /*sendToAnyEvent*/) { }
296
297     virtual bool isURLAttribute(const Attribute&) const { return false; }
298
299     KURL getURLAttribute(const QualifiedName&) const;
300     KURL getNonEmptyURLAttribute(const QualifiedName&) const;
301
302     virtual const QualifiedName& imageSourceAttributeName() const;
303     virtual String target() const { return String(); }
304
305     virtual void focus(bool restorePreviousSelection = true);
306     virtual void updateFocusAppearance(bool restorePreviousSelection);
307     virtual void blur();
308
309     String innerText();
310     String outerText();
311  
312     virtual String title() const;
313
314     const AtomicString& pseudo() const;
315     void setPseudo(const AtomicString&);
316
317     void updateId(const AtomicString& oldId, const AtomicString& newId);
318     void updateId(TreeScope*, const AtomicString& oldId, const AtomicString& newId);
319     void updateName(const AtomicString& oldName, const AtomicString& newName);
320     void updateLabel(TreeScope*, const AtomicString& oldForAttributeValue, const AtomicString& newForAttributeValue);
321
322     void removeCachedHTMLCollection(HTMLCollection*, CollectionType);
323
324     LayoutSize minimumSizeForResizing() const;
325     void setMinimumSizeForResizing(const LayoutSize&);
326
327     // Use Document::registerForDocumentActivationCallbacks() to subscribe to these
328     virtual void documentWillSuspendForPageCache() { }
329     virtual void documentDidResumeFromPageCache() { }
330
331     // Use Document::registerForMediaVolumeCallbacks() to subscribe to this
332     virtual void mediaVolumeDidChange() { }
333
334     // Use Document::registerForPrivateBrowsingStateChangedCallbacks() to subscribe to this.
335     virtual void privateBrowsingStateDidChange() { }
336
337     virtual void didBecomeFullscreenElement() { }
338     virtual void willStopBeingFullscreenElement() { }
339
340     bool isFinishedParsingChildren() const { return isParsingChildrenFinished(); }
341     virtual void finishParsingChildren();
342     virtual void beginParsingChildren();
343
344     // ElementTraversal API
345     Element* firstElementChild() const;
346     Element* lastElementChild() const;
347     Element* previousElementSibling() const;
348     Element* nextElementSibling() const;
349     unsigned childElementCount() const;
350
351     virtual bool shouldMatchReadOnlySelector() const;
352     virtual bool shouldMatchReadWriteSelector() const;
353     bool webkitMatchesSelector(const String& selectors, ExceptionCode&);
354
355     DOMTokenList* classList();
356     DOMTokenList* optionalClassList() const;
357
358     DOMStringMap* dataset();
359
360 #if ENABLE(MATHML)
361     virtual bool isMathMLElement() const { return false; }
362 #else
363     static bool isMathMLElement() { return false; }
364 #endif
365
366 #if ENABLE(VIDEO)
367     virtual bool isMediaElement() const { return false; }
368 #endif
369
370 #if ENABLE(INPUT_SPEECH)
371     virtual bool isInputFieldSpeechButtonElement() const { return false; }
372 #endif
373
374     virtual bool isFormControlElement() const { return false; }
375     virtual bool isEnabledFormControl() const { return true; }
376     virtual bool isSpinButtonElement() const { return false; }
377     virtual bool isTextFormControl() const { return false; }
378     virtual bool isOptionalFormControl() const { return false; }
379     virtual bool isRequiredFormControl() const { return false; }
380     virtual bool isDefaultButtonForForm() const { return false; }
381     virtual bool willValidate() const { return false; }
382     virtual bool isValidFormControlElement() { return false; }
383     virtual bool hasUnacceptableValue() const { return false; }
384     virtual bool isInRange() const { return false; }
385     virtual bool isOutOfRange() const { return false; }
386     virtual bool isFrameElementBase() const { return false; }
387     virtual bool isTextFieldDecoration() const { return false; }
388
389     virtual bool canContainRangeEndPoint() const { return true; }
390
391     virtual const AtomicString& formControlType() const { return nullAtom; }
392
393     virtual bool wasChangedSinceLastFormControlChangeEvent() const;
394     virtual void setChangedSinceLastFormControlChangeEvent(bool);
395     virtual void dispatchFormControlChangeEvent() { }
396
397 #if ENABLE(SVG)
398     virtual bool childShouldCreateRenderer(const NodeRenderingContext&) const;
399 #endif
400     
401 #if ENABLE(FULLSCREEN_API)
402     enum {
403         ALLOW_KEYBOARD_INPUT = 1 << 0,
404         LEGACY_MOZILLA_REQUEST = 1 << 1,
405     };
406     
407     void webkitRequestFullScreen(unsigned short flags);
408     virtual bool containsFullScreenElement() const;
409     virtual void setContainsFullScreenElement(bool);
410     virtual void setContainsFullScreenElementOnAncestorsCrossingFrameBoundaries(bool);
411
412     // W3C API
413     void webkitRequestFullscreen();
414 #endif
415
416 #if ENABLE(POINTER_LOCK)
417     void webkitRequestPointerLock();
418 #endif
419
420     virtual bool isSpellCheckingEnabled() const;
421
422     PassRefPtr<WebKitAnimationList> webkitGetAnimations() const;
423     
424     PassRefPtr<RenderStyle> styleForRenderer();
425
426     RenderRegion* renderRegion() const;
427 #if ENABLE(CSS_REGIONS)
428     const AtomicString& webkitRegionOverset() const;
429     Vector<RefPtr<Range> > webkitGetRegionFlowRanges() const;
430 #endif
431
432     bool hasID() const;
433     bool hasClass() const;
434     const SpaceSplitString& classNames() const;
435
436     IntSize savedLayerScrollOffset() const;
437     void setSavedLayerScrollOffset(const IntSize&);
438
439     virtual void reportMemoryUsage(MemoryObjectInfo*) const OVERRIDE;
440
441 protected:
442     Element(const QualifiedName& tagName, Document* document, ConstructionType type)
443         : ContainerNode(document, type)
444         , m_tagName(tagName)
445     {
446     }
447
448     virtual InsertionNotificationRequest insertedInto(ContainerNode*) OVERRIDE;
449     virtual void removedFrom(ContainerNode*) OVERRIDE;
450     virtual void childrenChanged(bool changedByParser = false, Node* beforeChange = 0, Node* afterChange = 0, int childCountDelta = 0);
451
452     virtual bool willRecalcStyle(StyleChange);
453     virtual void didRecalcStyle(StyleChange);
454     virtual PassRefPtr<RenderStyle> customStyleForRenderer();
455
456     virtual bool shouldRegisterAsNamedItem() const { return false; }
457     virtual bool shouldRegisterAsExtraNamedItem() const { return false; }
458
459     PassRefPtr<HTMLCollection> ensureCachedHTMLCollection(CollectionType);
460     HTMLCollection* cachedHTMLCollection(CollectionType);
461
462     // classAttributeChanged() exists to share code between
463     // parseAttribute (called via setAttribute()) and
464     // svgAttributeChanged (called when element.className.baseValue is set)
465     void classAttributeChanged(const AtomicString& newClassString);
466
467 private:
468     // FIXME: Remove the need for Attr to call willModifyAttribute/didModifyAttribute.
469     friend class Attr;
470
471     enum SynchronizationOfLazyAttribute { NotInSynchronizationOfLazyAttribute = 0, InSynchronizationOfLazyAttribute };
472
473     void didAddAttribute(const QualifiedName&, const AtomicString&);
474     void willModifyAttribute(const QualifiedName&, const AtomicString& oldValue, const AtomicString& newValue);
475     void didModifyAttribute(const QualifiedName&, const AtomicString&);
476     void didRemoveAttribute(const QualifiedName&);
477
478     void updateInvalidAttributes() const;
479
480     void scrollByUnits(int units, ScrollGranularity);
481
482     virtual void setPrefix(const AtomicString&, ExceptionCode&);
483     virtual NodeType nodeType() const;
484     virtual bool childTypeAllowed(NodeType) const;
485
486     void setAttributeInternal(size_t index, const QualifiedName&, const AtomicString& value, SynchronizationOfLazyAttribute);
487     void addAttributeInternal(const QualifiedName&, const AtomicString& value, SynchronizationOfLazyAttribute);
488     void removeAttributeInternal(size_t index, SynchronizationOfLazyAttribute);
489
490 #ifndef NDEBUG
491     virtual void formatForDebugger(char* buffer, unsigned length) const;
492 #endif
493
494     bool pseudoStyleCacheIsInvalid(const RenderStyle* currentStyle, RenderStyle* newStyle);
495
496     virtual void updateStyleAttribute() const { }
497
498 #if ENABLE(SVG)
499     virtual void updateAnimatedSVGAttribute(const QualifiedName&) const { }
500 #endif
501
502     void cancelFocusAppearanceUpdate();
503
504     virtual const AtomicString& virtualPrefix() const { return prefix(); }
505     virtual const AtomicString& virtualLocalName() const { return localName(); }
506     virtual const AtomicString& virtualNamespaceURI() const { return namespaceURI(); }
507     virtual RenderStyle* virtualComputedStyle(PseudoId pseudoElementSpecifier = NOPSEUDO) { return computedStyle(pseudoElementSpecifier); }
508     
509     // cloneNode is private so that non-virtual cloneElementWithChildren and cloneElementWithoutChildren
510     // are used instead.
511     virtual PassRefPtr<Node> cloneNode(bool deep);
512     virtual PassRefPtr<Element> cloneElementWithoutAttributesAndChildren();
513
514     QualifiedName m_tagName;
515     virtual OwnPtr<NodeRareData> createRareData();
516
517     SpellcheckAttributeState spellcheckAttributeState() const;
518
519     void updateNamedItemRegistration(const AtomicString& oldName, const AtomicString& newName);
520     void updateExtraNamedItemRegistration(const AtomicString& oldName, const AtomicString& newName);
521
522     void unregisterNamedFlowContentNode();
523
524     void createMutableAttributeData();
525
526     bool shouldInvalidateDistributionWhenAttributeChanged(ElementShadow*, const QualifiedName&, const AtomicString&);
527
528 private:
529     ElementRareData* elementRareData() const;
530     ElementRareData* ensureElementRareData();
531
532     void detachAllAttrNodesFromElement();
533     void detachAttrNodeFromElementWithValue(Attr*, const AtomicString& value);
534
535     RefPtr<ElementAttributeData> m_attributeData;
536 };
537     
538 inline Element* toElement(Node* node)
539 {
540     ASSERT(!node || node->isElementNode());
541     return static_cast<Element*>(node);
542 }
543
544 inline const Element* toElement(const Node* node)
545 {
546     ASSERT(!node || node->isElementNode());
547     return static_cast<const Element*>(node);
548 }
549
550 // This will catch anyone doing an unnecessary cast.
551 void toElement(const Element*);
552
553 inline bool Node::hasTagName(const QualifiedName& name) const
554 {
555     return isElementNode() && toElement(this)->hasTagName(name);
556 }
557     
558 inline bool Node::hasLocalName(const AtomicString& name) const
559 {
560     return isElementNode() && toElement(this)->hasLocalName(name);
561 }
562
563 inline bool Node::hasAttributes() const
564 {
565     return isElementNode() && toElement(this)->hasAttributes();
566 }
567
568 inline NamedNodeMap* Node::attributes() const
569 {
570     return isElementNode() ? toElement(this)->attributes() : 0;
571 }
572
573 inline Element* Node::parentElement() const
574 {
575     ContainerNode* parent = parentNode();
576     return parent && parent->isElementNode() ? toElement(parent) : 0;
577 }
578
579 inline Element* Element::previousElementSibling() const
580 {
581     Node* n = previousSibling();
582     while (n && !n->isElementNode())
583         n = n->previousSibling();
584     return static_cast<Element*>(n);
585 }
586
587 inline Element* Element::nextElementSibling() const
588 {
589     Node* n = nextSibling();
590     while (n && !n->isElementNode())
591         n = n->nextSibling();
592     return static_cast<Element*>(n);
593 }
594
595 inline const ElementAttributeData* Element::updatedAttributeData() const
596 {
597     updateInvalidAttributes();
598     return attributeData();
599 }
600
601 inline const ElementAttributeData* Element::ensureAttributeData()
602 {
603     if (attributeData())
604         return attributeData();
605     return mutableAttributeData();
606 }
607
608 inline const ElementAttributeData* Element::ensureUpdatedAttributeData() const
609 {
610     updateInvalidAttributes();
611     if (attributeData())
612         return attributeData();
613     return const_cast<Element*>(this)->mutableAttributeData();
614 }
615
616 inline void Element::updateName(const AtomicString& oldName, const AtomicString& newName)
617 {
618     if (!inDocument())
619         return;
620
621     if (oldName == newName)
622         return;
623
624     if (shouldRegisterAsNamedItem())
625         updateNamedItemRegistration(oldName, newName);
626 }
627
628 inline void Element::updateId(const AtomicString& oldId, const AtomicString& newId)
629 {
630     if (!inDocument())
631         return;
632
633     if (oldId == newId)
634         return;
635
636     updateId(treeScope(), oldId, newId);
637 }
638
639 inline void Element::updateId(TreeScope* scope, const AtomicString& oldId, const AtomicString& newId)
640 {
641     ASSERT(inDocument());
642     ASSERT(oldId != newId);
643
644     if (!oldId.isEmpty())
645         scope->removeElementById(oldId, this);
646     if (!newId.isEmpty())
647         scope->addElementById(newId, this);
648
649     if (shouldRegisterAsExtraNamedItem())
650         updateExtraNamedItemRegistration(oldId, newId);
651 }
652
653 inline bool Element::fastHasAttribute(const QualifiedName& name) const
654 {
655     ASSERT(fastAttributeLookupAllowed(name));
656     return attributeData() && getAttributeItem(name);
657 }
658
659 inline const AtomicString& Element::fastGetAttribute(const QualifiedName& name) const
660 {
661     ASSERT(fastAttributeLookupAllowed(name));
662     if (attributeData()) {
663         if (const Attribute* attribute = getAttributeItem(name))
664             return attribute->value();
665     }
666     return nullAtom;
667 }
668
669 inline bool Element::hasAttributesWithoutUpdate() const
670 {
671     return attributeData() && !attributeData()->isEmpty();
672 }
673
674 inline const AtomicString& Element::idForStyleResolution() const
675 {
676     ASSERT(hasID());
677     return attributeData()->idForStyleResolution();
678 }
679
680 inline bool Element::isIdAttributeName(const QualifiedName& attributeName) const
681 {
682     // FIXME: This check is probably not correct for the case where the document has an id attribute
683     // with a non-null namespace, because it will return false, a false negative, if the prefixes
684     // don't match but the local name and namespace both do. However, since this has been like this
685     // for a while and the code paths may be hot, we'll have to measure performance if we fix it.
686     return attributeName == document()->idAttributeName();
687 }
688
689 inline const AtomicString& Element::getIdAttribute() const
690 {
691     return hasID() ? fastGetAttribute(document()->idAttributeName()) : nullAtom;
692 }
693
694 inline const AtomicString& Element::getNameAttribute() const
695 {
696     return hasName() ? fastGetAttribute(HTMLNames::nameAttr) : nullAtom;
697 }
698
699 inline void Element::setIdAttribute(const AtomicString& value)
700 {
701     setAttribute(document()->idAttributeName(), value);
702 }
703
704 inline const SpaceSplitString& Element::classNames() const
705 {
706     ASSERT(hasClass());
707     ASSERT(attributeData());
708     return attributeData()->classNames();
709 }
710
711 inline size_t Element::attributeCount() const
712 {
713     ASSERT(attributeData());
714     return attributeData()->length();
715 }
716
717 inline const Attribute* Element::attributeItem(unsigned index) const
718 {
719     ASSERT(attributeData());
720     return attributeData()->attributeItem(index);
721 }
722
723 inline const Attribute* Element::getAttributeItem(const QualifiedName& name) const
724 {
725     ASSERT(attributeData());
726     return attributeData()->getAttributeItem(name);
727 }
728
729 inline Attribute* Element::getAttributeItem(const QualifiedName& name)
730 {
731     ASSERT(attributeData());
732     return mutableAttributeData()->getAttributeItem(name);
733 }
734
735 inline void Element::updateInvalidAttributes() const
736 {
737     if (attributeData() && attributeData()->m_styleAttributeIsDirty)
738         updateStyleAttribute();
739
740 #if ENABLE(SVG)
741     if (!areSVGAttributesValid())
742         updateAnimatedSVGAttribute(anyQName());
743 #endif
744 }
745
746 inline Element* firstElementChild(const ContainerNode* container)
747 {
748     ASSERT_ARG(container, container);
749     Node* child = container->firstChild();
750     while (child && !child->isElementNode())
751         child = child->nextSibling();
752     return static_cast<Element*>(child);
753 }
754
755 inline bool Element::hasID() const
756 {
757     return attributeData() && attributeData()->hasID();
758 }
759
760 inline bool Element::hasClass() const
761 {
762     return attributeData() && attributeData()->hasClass();
763 }
764
765 inline ElementAttributeData* Element::mutableAttributeData()
766 {
767     if (!attributeData() || !attributeData()->isMutable())
768         createMutableAttributeData();
769     return m_attributeData.get();
770 }
771
772 // Put here to make them inline.
773 inline bool Node::hasID() const
774 {
775     return isElementNode() && toElement(this)->hasID();
776 }
777
778 inline bool Node::hasClass() const
779 {
780     return isElementNode() && toElement(this)->hasClass();
781 }
782
783 inline bool isShadowHost(const Node* node)
784 {
785     return node && node->isElementNode() && toElement(node)->shadow();
786 }
787
788 } // namespace
789
790 #endif