Remove unused method and de-virtualize others in Element.h
[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, 2013 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 "Attribute.h"
29 #include "CollectionType.h"
30 #include "Document.h"
31 #include "HTMLNames.h"
32 #include "ScrollTypes.h"
33 #include "SpaceSplitString.h"
34
35 namespace WebCore {
36
37 class Attr;
38 class ClientRect;
39 class ClientRectList;
40 class DOMStringMap;
41 class DOMTokenList;
42 class Element;
43 class ElementRareData;
44 class ElementShadow;
45 class ShareableElementData;
46 class IntSize;
47 class Locale;
48 class UniqueElementData;
49 class PseudoElement;
50 class RenderRegion;
51 class ShadowRoot;
52 class StylePropertySet;
53
54 class ElementData : public RefCounted<ElementData> {
55     WTF_MAKE_FAST_ALLOCATED;
56 public:
57     // Override RefCounted's deref() to ensure operator delete is called on
58     // the appropriate subclass type.
59     void deref();
60
61     static const unsigned attributeNotFound = static_cast<unsigned>(-1);
62
63     void clearClass() const { m_classNames.clear(); }
64     void setClass(const AtomicString& className, bool shouldFoldCase) const { m_classNames.set(className, shouldFoldCase); }
65     const SpaceSplitString& classNames() const { return m_classNames; }
66
67     const AtomicString& idForStyleResolution() const { return m_idForStyleResolution; }
68     void setIdForStyleResolution(const AtomicString& newId) const { m_idForStyleResolution = newId; }
69
70     const StylePropertySet* inlineStyle() const { return m_inlineStyle.get(); }
71
72     const StylePropertySet* presentationAttributeStyle() const;
73
74     unsigned length() const;
75     bool isEmpty() const { return !length(); }
76
77     const Attribute* attributeItem(unsigned index) const;
78     const Attribute* getAttributeItem(const QualifiedName&) const;
79     unsigned getAttributeItemIndex(const QualifiedName&) const;
80     unsigned getAttributeItemIndex(const AtomicString& name, bool shouldIgnoreAttributeCase) const;
81
82     bool hasID() const { return !m_idForStyleResolution.isNull(); }
83     bool hasClass() const { return !m_classNames.isNull(); }
84
85     bool isEquivalent(const ElementData* other) const;
86
87     bool isUnique() const { return m_isUnique; }
88
89 protected:
90     ElementData();
91     ElementData(unsigned arraySize);
92     ElementData(const ElementData&, bool isUnique);
93
94     unsigned m_isUnique : 1;
95     unsigned m_arraySize : 28;
96     mutable unsigned m_presentationAttributeStyleIsDirty : 1;
97     mutable unsigned m_styleAttributeIsDirty : 1;
98 #if ENABLE(SVG)
99     mutable unsigned m_animatedSVGAttributesAreDirty : 1;
100 #endif
101
102     mutable RefPtr<StylePropertySet> m_inlineStyle;
103     mutable SpaceSplitString m_classNames;
104     mutable AtomicString m_idForStyleResolution;
105
106 private:
107     friend class Element;
108     friend class StyledElement;
109     friend class ShareableElementData;
110     friend class UniqueElementData;
111 #if ENABLE(SVG)
112     friend class SVGElement;
113 #endif
114
115     const Attribute* attributeBase() const;
116     const Attribute* getAttributeItem(const AtomicString& name, bool shouldIgnoreAttributeCase) const;
117     unsigned getAttributeItemIndexSlowCase(const AtomicString& name, bool shouldIgnoreAttributeCase) const;
118
119     PassRefPtr<UniqueElementData> makeUniqueCopy() const;
120 };
121
122 #if COMPILER(MSVC)
123 #pragma warning(push)
124 #pragma warning(disable: 4200) // Disable "zero-sized array in struct/union" warning
125 #endif
126
127 class ShareableElementData : public ElementData {
128 public:
129     static PassRefPtr<ShareableElementData> createWithAttributes(const Vector<Attribute>&);
130
131     explicit ShareableElementData(const Vector<Attribute>&);
132     explicit ShareableElementData(const UniqueElementData&);
133     ~ShareableElementData();
134
135     Attribute m_attributeArray[0];
136 };
137
138 #if COMPILER(MSVC)
139 #pragma warning(pop)
140 #endif
141
142 class UniqueElementData : public ElementData {
143 public:
144     static PassRefPtr<UniqueElementData> create();
145     PassRefPtr<ShareableElementData> makeShareableCopy() const;
146
147     // These functions do no error/duplicate checking.
148     void addAttribute(const QualifiedName&, const AtomicString&);
149     void removeAttribute(unsigned index);
150
151     Attribute* attributeItem(unsigned index);
152     Attribute* getAttributeItem(const QualifiedName&);
153
154     UniqueElementData();
155     explicit UniqueElementData(const ShareableElementData&);
156     explicit UniqueElementData(const UniqueElementData&);
157
158     mutable RefPtr<StylePropertySet> m_presentationAttributeStyle;
159     Vector<Attribute, 4> m_attributeVector;
160 };
161
162 enum AffectedSelectorType {
163     AffectedSelectorChecked = 1,
164     AffectedSelectorEnabled = 1 << 1,
165     AffectedSelectorDisabled = 1 << 2,
166     AffectedSelectorIndeterminate = 1 << 3,
167     AffectedSelectorLink = 1 << 4,
168     AffectedSelectorTarget = 1 << 5,
169     AffectedSelectorVisited = 1 << 6
170 };
171 typedef int AffectedSelectorMask;
172
173 enum SpellcheckAttributeState {
174     SpellcheckAttributeTrue,
175     SpellcheckAttributeFalse,
176     SpellcheckAttributeDefault
177 };
178
179 class Element : public ContainerNode {
180 public:
181     static PassRefPtr<Element> create(const QualifiedName&, Document*);
182     virtual ~Element();
183
184     DEFINE_ATTRIBUTE_EVENT_LISTENER(abort);
185     DEFINE_ATTRIBUTE_EVENT_LISTENER(change);
186     DEFINE_ATTRIBUTE_EVENT_LISTENER(click);
187     DEFINE_ATTRIBUTE_EVENT_LISTENER(contextmenu);
188     DEFINE_ATTRIBUTE_EVENT_LISTENER(dblclick);
189     DEFINE_ATTRIBUTE_EVENT_LISTENER(dragenter);
190     DEFINE_ATTRIBUTE_EVENT_LISTENER(dragover);
191     DEFINE_ATTRIBUTE_EVENT_LISTENER(dragleave);
192     DEFINE_ATTRIBUTE_EVENT_LISTENER(drop);
193     DEFINE_ATTRIBUTE_EVENT_LISTENER(dragstart);
194     DEFINE_ATTRIBUTE_EVENT_LISTENER(drag);
195     DEFINE_ATTRIBUTE_EVENT_LISTENER(dragend);
196     DEFINE_ATTRIBUTE_EVENT_LISTENER(input);
197     DEFINE_ATTRIBUTE_EVENT_LISTENER(invalid);
198     DEFINE_ATTRIBUTE_EVENT_LISTENER(keydown);
199     DEFINE_ATTRIBUTE_EVENT_LISTENER(keypress);
200     DEFINE_ATTRIBUTE_EVENT_LISTENER(keyup);
201     DEFINE_ATTRIBUTE_EVENT_LISTENER(mousedown);
202     DEFINE_ATTRIBUTE_EVENT_LISTENER(mouseenter);
203     DEFINE_ATTRIBUTE_EVENT_LISTENER(mouseleave);
204     DEFINE_ATTRIBUTE_EVENT_LISTENER(mousemove);
205     DEFINE_ATTRIBUTE_EVENT_LISTENER(mouseout);
206     DEFINE_ATTRIBUTE_EVENT_LISTENER(mouseover);
207     DEFINE_ATTRIBUTE_EVENT_LISTENER(mouseup);
208     DEFINE_ATTRIBUTE_EVENT_LISTENER(mousewheel);
209     DEFINE_ATTRIBUTE_EVENT_LISTENER(scroll);
210     DEFINE_ATTRIBUTE_EVENT_LISTENER(select);
211     DEFINE_ATTRIBUTE_EVENT_LISTENER(submit);
212
213     // These four attribute event handler attributes are overridden by HTMLBodyElement
214     // and HTMLFrameSetElement to forward to the DOMWindow.
215     DECLARE_VIRTUAL_ATTRIBUTE_EVENT_LISTENER(blur);
216     DECLARE_VIRTUAL_ATTRIBUTE_EVENT_LISTENER(error);
217     DECLARE_VIRTUAL_ATTRIBUTE_EVENT_LISTENER(focus);
218     DECLARE_VIRTUAL_ATTRIBUTE_EVENT_LISTENER(load);
219
220     // WebKit extensions
221     DEFINE_ATTRIBUTE_EVENT_LISTENER(beforecut);
222     DEFINE_ATTRIBUTE_EVENT_LISTENER(cut);
223     DEFINE_ATTRIBUTE_EVENT_LISTENER(beforecopy);
224     DEFINE_ATTRIBUTE_EVENT_LISTENER(copy);
225     DEFINE_ATTRIBUTE_EVENT_LISTENER(beforepaste);
226     DEFINE_ATTRIBUTE_EVENT_LISTENER(paste);
227     DEFINE_ATTRIBUTE_EVENT_LISTENER(reset);
228     DEFINE_ATTRIBUTE_EVENT_LISTENER(search);
229     DEFINE_ATTRIBUTE_EVENT_LISTENER(selectstart);
230 #if ENABLE(TOUCH_EVENTS)
231     DEFINE_ATTRIBUTE_EVENT_LISTENER(touchstart);
232     DEFINE_ATTRIBUTE_EVENT_LISTENER(touchmove);
233     DEFINE_ATTRIBUTE_EVENT_LISTENER(touchend);
234     DEFINE_ATTRIBUTE_EVENT_LISTENER(touchcancel);
235 #endif
236 #if ENABLE(FULLSCREEN_API)
237     DEFINE_ATTRIBUTE_EVENT_LISTENER(webkitfullscreenchange);
238     DEFINE_ATTRIBUTE_EVENT_LISTENER(webkitfullscreenerror);
239 #endif
240
241     bool hasAttribute(const QualifiedName&) const;
242     const AtomicString& getAttribute(const QualifiedName&) const;
243     void setAttribute(const QualifiedName&, const AtomicString& value);
244     void setSynchronizedLazyAttribute(const QualifiedName&, const AtomicString& value);
245     void removeAttribute(const QualifiedName&);
246
247     // Typed getters and setters for language bindings.
248     int getIntegralAttribute(const QualifiedName& attributeName) const;
249     void setIntegralAttribute(const QualifiedName& attributeName, int value);
250     unsigned getUnsignedIntegralAttribute(const QualifiedName& attributeName) const;
251     void setUnsignedIntegralAttribute(const QualifiedName& attributeName, unsigned value);
252
253     // Call this to get the value of an attribute that is known not to be the style
254     // attribute or one of the SVG animatable attributes.
255     bool fastHasAttribute(const QualifiedName&) const;
256     const AtomicString& fastGetAttribute(const QualifiedName&) const;
257 #ifndef NDEBUG
258     bool fastAttributeLookupAllowed(const QualifiedName&) const;
259 #endif
260
261 #ifdef DUMP_NODE_STATISTICS
262     bool hasNamedNodeMap() const;
263 #endif
264     bool hasAttributes() const;
265     // This variant will not update the potentially invalid attributes. To be used when not interested
266     // in style attribute or one of the SVG animation attributes.
267     bool hasAttributesWithoutUpdate() const;
268
269     bool hasAttribute(const AtomicString& name) const;
270     bool hasAttributeNS(const AtomicString& namespaceURI, const AtomicString& localName) const;
271
272     const AtomicString& getAttribute(const AtomicString& name) const;
273     const AtomicString& getAttributeNS(const AtomicString& namespaceURI, const AtomicString& localName) const;
274
275     void setAttribute(const AtomicString& name, const AtomicString& value, ExceptionCode&);
276     static bool parseAttributeName(QualifiedName&, const AtomicString& namespaceURI, const AtomicString& qualifiedName, ExceptionCode&);
277     void setAttributeNS(const AtomicString& namespaceURI, const AtomicString& qualifiedName, const AtomicString& value, ExceptionCode&);
278
279     bool isIdAttributeName(const QualifiedName&) const;
280     const AtomicString& getIdAttribute() const;
281     void setIdAttribute(const AtomicString&);
282
283     const AtomicString& getNameAttribute() const;
284
285     // Call this to get the value of the id attribute for style resolution purposes.
286     // The value will already be lowercased if the document is in compatibility mode,
287     // so this function is not suitable for non-style uses.
288     const AtomicString& idForStyleResolution() const;
289
290     // Internal methods that assume the existence of attribute storage, one should use hasAttributes()
291     // before calling them.
292     unsigned attributeCount() const;
293     const Attribute* attributeItem(unsigned index) const;
294     const Attribute* getAttributeItem(const QualifiedName&) const;
295     unsigned getAttributeItemIndex(const QualifiedName& name) const { return elementData()->getAttributeItemIndex(name); }
296     unsigned getAttributeItemIndex(const AtomicString& name, bool shouldIgnoreAttributeCase) const { return elementData()->getAttributeItemIndex(name, shouldIgnoreAttributeCase); }
297
298     void scrollIntoView(bool alignToTop = true);
299     void scrollIntoViewIfNeeded(bool centerIfNeeded = true);
300
301     void scrollByLines(int lines);
302     void scrollByPages(int pages);
303
304     int offsetLeft();
305     int offsetTop();
306     int offsetWidth();
307     int offsetHeight();
308
309     // FIXME: Replace uses of offsetParent in the platform with calls
310     // to the render layer and merge bindingsOffsetParent and offsetParent.
311     Element* bindingsOffsetParent();
312
313     Element* offsetParent();
314     int clientLeft();
315     int clientTop();
316     int clientWidth();
317     int clientHeight();
318     virtual int scrollLeft();
319     virtual int scrollTop();
320     virtual void setScrollLeft(int);
321     virtual void setScrollTop(int);
322     virtual int scrollWidth();
323     virtual int scrollHeight();
324
325     IntRect boundsInRootViewSpace();
326
327     PassRefPtr<ClientRectList> getClientRects();
328     PassRefPtr<ClientRect> getBoundingClientRect();
329     
330     // Returns the absolute bounding box translated into screen coordinates:
331     IntRect screenRect() const;
332
333     void removeAttribute(const AtomicString& name);
334     void removeAttributeNS(const AtomicString& namespaceURI, const AtomicString& localName);
335
336     PassRefPtr<Attr> detachAttribute(unsigned index);
337
338     PassRefPtr<Attr> getAttributeNode(const AtomicString& name);
339     PassRefPtr<Attr> getAttributeNodeNS(const AtomicString& namespaceURI, const AtomicString& localName);
340     PassRefPtr<Attr> setAttributeNode(Attr*, ExceptionCode&);
341     PassRefPtr<Attr> setAttributeNodeNS(Attr*, ExceptionCode&);
342     PassRefPtr<Attr> removeAttributeNode(Attr*, ExceptionCode&);
343
344     PassRefPtr<Attr> attrIfExists(const QualifiedName&);
345     PassRefPtr<Attr> ensureAttr(const QualifiedName&);
346
347     const Vector<RefPtr<Attr> >& attrNodeList();
348
349     virtual CSSStyleDeclaration* style();
350
351     const QualifiedName& tagQName() const { return m_tagName; }
352     String tagName() const { return nodeName(); }
353     bool hasTagName(const QualifiedName& tagName) const { return m_tagName.matches(tagName); }
354     
355     // A fast function for checking the local name against another atomic string.
356     bool hasLocalName(const AtomicString& other) const { return m_tagName.localName() == other; }
357     bool hasLocalName(const QualifiedName& other) const { return m_tagName.localName() == other.localName(); }
358
359     const AtomicString& localName() const { return m_tagName.localName(); }
360     const AtomicString& prefix() const { return m_tagName.prefix(); }
361     const AtomicString& namespaceURI() const { return m_tagName.namespaceURI(); }
362
363     virtual KURL baseURI() const;
364
365     virtual String nodeName() const;
366
367     PassRefPtr<Element> cloneElementWithChildren();
368     PassRefPtr<Element> cloneElementWithoutChildren();
369
370     void normalizeAttributes();
371     String nodeNamePreservingCase() const;
372
373     void setBooleanAttribute(const QualifiedName& name, bool);
374
375     // For exposing to DOM only.
376     NamedNodeMap* attributes() const;
377
378     enum AttributeModificationReason {
379         ModifiedDirectly,
380         ModifiedByCloning
381     };
382
383     // This method is called whenever an attribute is added, changed or removed.
384     virtual void attributeChanged(const QualifiedName&, const AtomicString&, AttributeModificationReason = ModifiedDirectly);
385     virtual void parseAttribute(const QualifiedName&, const AtomicString&) { }
386
387     // Only called by the parser immediately after element construction.
388     void parserSetAttributes(const Vector<Attribute>&);
389
390     // Remove attributes that might introduce scripting from the vector leaving the element unchanged.
391     void stripScriptingAttributes(Vector<Attribute>&) const;
392
393     const ElementData* elementData() const { return m_elementData.get(); }
394     UniqueElementData* ensureUniqueElementData();
395
396     void synchronizeAllAttributes() const;
397
398     // Clones attributes only.
399     void cloneAttributesFromElement(const Element&);
400
401     // Clones all attribute-derived data, including subclass specifics (through copyNonAttributeProperties.)
402     void cloneDataFromElement(const Element&);
403
404     bool hasEquivalentAttributes(const Element* other) const;
405
406     virtual void copyNonAttributePropertiesFromElement(const Element&) { }
407
408     virtual void attach();
409     virtual void detach();
410     virtual RenderObject* createRenderer(RenderArena*, RenderStyle*);
411     virtual bool rendererIsNeeded(const NodeRenderingContext&);
412     void recalcStyle(StyleChange = NoChange);
413     void didAffectSelector(AffectedSelectorMask);
414
415     ElementShadow* shadow() const;
416     ElementShadow* ensureShadow();
417     PassRefPtr<ShadowRoot> createShadowRoot(ExceptionCode&);
418     ShadowRoot* authorShadowRoot() const;
419
420     bool hasAuthorShadowRoot() const { return authorShadowRoot(); }
421
422     ShadowRoot* userAgentShadowRoot() const;
423     ShadowRoot* ensureUserAgentShadowRoot();
424
425     virtual const AtomicString& shadowPseudoId() const;
426
427     RenderStyle* computedStyle(PseudoId = NOPSEUDO);
428
429     // Methods for indicating the style is affected by dynamic updates (e.g., children changing, our position changing in our sibling list, etc.)
430     bool styleAffectedByEmpty() const { return hasRareData() && rareDataStyleAffectedByEmpty(); }
431     bool childrenAffectedByHover() const { return hasRareData() && rareDataChildrenAffectedByHover(); }
432     bool childrenAffectedByActive() const { return hasRareData() && rareDataChildrenAffectedByActive(); }
433     bool childrenAffectedByDrag() const { return hasRareData() && rareDataChildrenAffectedByDrag(); }
434     bool childrenAffectedByPositionalRules() const { return hasRareData() && (rareDataChildrenAffectedByForwardPositionalRules() || rareDataChildrenAffectedByBackwardPositionalRules()); }
435     bool childrenAffectedByFirstChildRules() const { return hasRareData() && rareDataChildrenAffectedByFirstChildRules(); }
436     bool childrenAffectedByLastChildRules() const { return hasRareData() && rareDataChildrenAffectedByLastChildRules(); }
437     bool childrenAffectedByDirectAdjacentRules() const { return hasRareData() && rareDataChildrenAffectedByDirectAdjacentRules(); }
438     bool childrenAffectedByForwardPositionalRules() const { return hasRareData() && rareDataChildrenAffectedByForwardPositionalRules(); }
439     bool childrenAffectedByBackwardPositionalRules() const { return hasRareData() && rareDataChildrenAffectedByBackwardPositionalRules(); }
440     unsigned childIndex() const { return hasRareData() ? rareDataChildIndex() : 0; }
441
442     bool hasFlagsSetDuringStylingOfChildren() const;
443
444     void setStyleAffectedByEmpty();
445     void setChildrenAffectedByHover(bool);
446     void setChildrenAffectedByActive(bool);
447     void setChildrenAffectedByDrag(bool);
448     void setChildrenAffectedByFirstChildRules();
449     void setChildrenAffectedByLastChildRules();
450     void setChildrenAffectedByDirectAdjacentRules();
451     void setChildrenAffectedByForwardPositionalRules();
452     void setChildrenAffectedByBackwardPositionalRules();
453     void setChildIndex(unsigned);
454
455     void setIsInCanvasSubtree(bool);
456     bool isInCanvasSubtree() const;
457
458     AtomicString computeInheritedLanguage() const;
459     Locale& locale() const;
460
461     virtual void accessKeyAction(bool /*sendToAnyEvent*/) { }
462
463     virtual bool isURLAttribute(const Attribute&) const { return false; }
464     virtual bool isHTMLContentAttribute(const Attribute&) const { return false; }
465
466     KURL getURLAttribute(const QualifiedName&) const;
467     KURL getNonEmptyURLAttribute(const QualifiedName&) const;
468
469     virtual const AtomicString& imageSourceURL() const;
470     virtual String target() const { return String(); }
471
472     virtual void focus(bool restorePreviousSelection = true, FocusDirection = FocusDirectionNone);
473     virtual void updateFocusAppearance(bool restorePreviousSelection);
474     virtual void blur();
475
476     String innerText();
477     String outerText();
478  
479     virtual String title() const;
480
481     const AtomicString& pseudo() const;
482     void setPseudo(const AtomicString&);
483
484     LayoutSize minimumSizeForResizing() const;
485     void setMinimumSizeForResizing(const LayoutSize&);
486
487     // Use Document::registerForDocumentActivationCallbacks() to subscribe to these
488     virtual void documentWillSuspendForPageCache() { }
489     virtual void documentDidResumeFromPageCache() { }
490
491     // Use Document::registerForMediaVolumeCallbacks() to subscribe to this
492     virtual void mediaVolumeDidChange() { }
493
494     // Use Document::registerForPrivateBrowsingStateChangedCallbacks() to subscribe to this.
495     virtual void privateBrowsingStateDidChange() { }
496
497     virtual void didBecomeFullscreenElement() { }
498     virtual void willStopBeingFullscreenElement() { }
499
500 #if ENABLE(VIDEO_TRACK)
501     virtual void captionPreferencesChanged() { }
502 #endif
503
504     bool isFinishedParsingChildren() const { return isParsingChildrenFinished(); }
505     virtual void finishParsingChildren();
506     virtual void beginParsingChildren();
507
508     bool hasPseudoElements() const;
509     PseudoElement* pseudoElement(PseudoId) const;
510     RenderObject* pseudoElementRenderer(PseudoId) const;
511     bool childNeedsShadowWalker() const;
512     void didShadowTreeAwareChildrenChange();
513
514     // ElementTraversal API
515     Element* firstElementChild() const;
516     Element* lastElementChild() const;
517     Element* previousElementSibling() const;
518     Element* nextElementSibling() const;
519     unsigned childElementCount() const;
520
521     virtual bool matchesReadOnlyPseudoClass() const;
522     virtual bool matchesReadWritePseudoClass() const;
523     bool webkitMatchesSelector(const String& selectors, ExceptionCode&);
524     virtual bool shouldAppearIndeterminate() const;
525
526     DOMTokenList* classList();
527
528     DOMStringMap* dataset();
529
530 #if ENABLE(MATHML)
531     virtual bool isMathMLElement() const { return false; }
532 #else
533     static bool isMathMLElement() { return false; }
534 #endif
535
536 #if ENABLE(VIDEO)
537     virtual bool isMediaElement() const { return false; }
538 #endif
539
540 #if ENABLE(INPUT_SPEECH)
541     virtual bool isInputFieldSpeechButtonElement() const { return false; }
542 #endif
543 #if ENABLE(INPUT_MULTIPLE_FIELDS_UI)
544     virtual bool isDateTimeFieldElement() const;
545 #endif
546
547     virtual bool isFormControlElement() const { return false; }
548     virtual bool isSpinButtonElement() const { return false; }
549     virtual bool isTextFormControl() const { return false; }
550     virtual bool isOptionalFormControl() const { return false; }
551     virtual bool isRequiredFormControl() const { return false; }
552     virtual bool isDefaultButtonForForm() const { return false; }
553     virtual bool willValidate() const { return false; }
554     virtual bool isValidFormControlElement() { return false; }
555     virtual bool isInRange() const { return false; }
556     virtual bool isOutOfRange() const { return false; }
557     virtual bool isFrameElementBase() const { return false; }
558
559     virtual bool canContainRangeEndPoint() const { return true; }
560
561     virtual const AtomicString& formControlType() const { return nullAtom; }
562
563     virtual bool wasChangedSinceLastFormControlChangeEvent() const;
564     virtual void setChangedSinceLastFormControlChangeEvent(bool);
565     virtual void dispatchFormControlChangeEvent() { }
566
567     // Used for disabled form elements; if true, prevents mouse events from being dispatched
568     // to event listeners, and prevents DOMActivate events from being sent at all.
569     virtual bool isDisabledFormControl() const;
570
571 #if ENABLE(DIALOG_ELEMENT)
572     bool isInert() const;
573 #endif
574
575 #if ENABLE(SVG)
576     virtual bool childShouldCreateRenderer(const NodeRenderingContext&) const;
577     bool hasPendingResources() const;
578     void setHasPendingResources();
579     void clearHasPendingResources();
580     virtual void buildPendingResource() { };
581 #endif
582
583 #if ENABLE(FULLSCREEN_API)
584     enum {
585         ALLOW_KEYBOARD_INPUT = 1 << 0,
586         LEGACY_MOZILLA_REQUEST = 1 << 1,
587     };
588     
589     void webkitRequestFullScreen(unsigned short flags);
590     bool containsFullScreenElement() const;
591     void setContainsFullScreenElement(bool);
592     void setContainsFullScreenElementOnAncestorsCrossingFrameBoundaries(bool);
593
594     // W3C API
595     void webkitRequestFullscreen();
596 #endif
597
598 #if ENABLE(DIALOG_ELEMENT)
599     bool isInTopLayer() const;
600     void setIsInTopLayer(bool);
601 #endif
602
603 #if ENABLE(POINTER_LOCK)
604     void webkitRequestPointerLock();
605 #endif
606
607     virtual bool isSpellCheckingEnabled() const;
608
609     PassRefPtr<RenderStyle> styleForRenderer();
610
611     RenderRegion* renderRegion() const;
612     virtual bool moveToFlowThreadIsNeeded(RefPtr<RenderStyle>& cachedStyle);
613 #if ENABLE(CSS_REGIONS)
614     const AtomicString& webkitRegionOverset() const;
615     Vector<RefPtr<Range> > webkitGetRegionFlowRanges() const;
616 #endif
617
618     bool hasID() const;
619     bool hasClass() const;
620     const SpaceSplitString& classNames() const;
621
622     IntSize savedLayerScrollOffset() const;
623     void setSavedLayerScrollOffset(const IntSize&);
624
625 protected:
626     Element(const QualifiedName& tagName, Document* document, ConstructionType type)
627         : ContainerNode(document, type)
628         , m_tagName(tagName)
629     {
630     }
631
632     virtual InsertionNotificationRequest insertedInto(ContainerNode*) OVERRIDE;
633     virtual void removedFrom(ContainerNode*) OVERRIDE;
634     virtual void childrenChanged(bool changedByParser = false, Node* beforeChange = 0, Node* afterChange = 0, int childCountDelta = 0);
635     virtual void removeAllEventListeners() OVERRIDE;
636
637     virtual bool willRecalcStyle(StyleChange);
638     virtual void didRecalcStyle(StyleChange);
639     virtual PassRefPtr<RenderStyle> customStyleForRenderer();
640
641     void clearTabIndexExplicitlyIfNeeded();    
642     void setTabIndexExplicitly(short);
643     virtual bool supportsFocus() const OVERRIDE;
644     virtual short tabIndex() const OVERRIDE;
645
646     PassRefPtr<HTMLCollection> ensureCachedHTMLCollection(CollectionType);
647     HTMLCollection* cachedHTMLCollection(CollectionType);
648
649     // classAttributeChanged() exists to share code between
650     // parseAttribute (called via setAttribute()) and
651     // svgAttributeChanged (called when element.className.baseValue is set)
652     void classAttributeChanged(const AtomicString& newClassString);
653
654 private:
655     void updatePseudoElement(PseudoId, StyleChange = NoChange);
656     PassRefPtr<PseudoElement> createPseudoElementIfNeeded(PseudoId);
657     void setPseudoElement(PseudoId, PassRefPtr<PseudoElement>);
658
659     virtual bool areAuthorShadowsAllowed() const { return true; }
660     virtual void didAddUserAgentShadowRoot(ShadowRoot*) { }
661     virtual bool alwaysCreateUserAgentShadowRoot() const { return false; }
662
663     // FIXME: Remove the need for Attr to call willModifyAttribute/didModifyAttribute.
664     friend class Attr;
665
666     enum SynchronizationOfLazyAttribute { NotInSynchronizationOfLazyAttribute = 0, InSynchronizationOfLazyAttribute };
667
668     void didAddAttribute(const QualifiedName&, const AtomicString&);
669     void willModifyAttribute(const QualifiedName&, const AtomicString& oldValue, const AtomicString& newValue);
670     void didModifyAttribute(const QualifiedName&, const AtomicString&);
671     void didRemoveAttribute(const QualifiedName&);
672
673     void synchronizeAttribute(const QualifiedName&) const;
674     void synchronizeAttribute(const AtomicString& localName) const;
675
676     void updateId(const AtomicString& oldId, const AtomicString& newId);
677     void updateId(TreeScope*, const AtomicString& oldId, const AtomicString& newId);
678     void updateName(const AtomicString& oldName, const AtomicString& newName);
679     void updateName(TreeScope*, const AtomicString& oldName, const AtomicString& newName);
680     void updateLabel(TreeScope*, const AtomicString& oldForAttributeValue, const AtomicString& newForAttributeValue);
681
682     void scrollByUnits(int units, ScrollGranularity);
683
684     virtual void setPrefix(const AtomicString&, ExceptionCode&);
685     virtual NodeType nodeType() const;
686     virtual bool childTypeAllowed(NodeType) const;
687
688     void setAttributeInternal(unsigned index, const QualifiedName&, const AtomicString& value, SynchronizationOfLazyAttribute);
689     void addAttributeInternal(const QualifiedName&, const AtomicString& value, SynchronizationOfLazyAttribute);
690     void removeAttributeInternal(unsigned index, SynchronizationOfLazyAttribute);
691     void attributeChangedFromParserOrByCloning(const QualifiedName&, const AtomicString&, AttributeModificationReason);
692
693 #ifndef NDEBUG
694     virtual void formatForDebugger(char* buffer, unsigned length) const;
695 #endif
696
697     bool pseudoStyleCacheIsInvalid(const RenderStyle* currentStyle, RenderStyle* newStyle);
698
699     void cancelFocusAppearanceUpdate();
700
701     virtual const AtomicString& virtualPrefix() const { return prefix(); }
702     virtual const AtomicString& virtualLocalName() const { return localName(); }
703     virtual const AtomicString& virtualNamespaceURI() const { return namespaceURI(); }
704     virtual RenderStyle* virtualComputedStyle(PseudoId pseudoElementSpecifier = NOPSEUDO) { return computedStyle(pseudoElementSpecifier); }
705     
706     // cloneNode is private so that non-virtual cloneElementWithChildren and cloneElementWithoutChildren
707     // are used instead.
708     virtual PassRefPtr<Node> cloneNode(bool deep) OVERRIDE;
709     virtual PassRefPtr<Element> cloneElementWithoutAttributesAndChildren();
710
711     QualifiedName m_tagName;
712     bool rareDataStyleAffectedByEmpty() const;
713     bool rareDataChildrenAffectedByHover() const;
714     bool rareDataChildrenAffectedByActive() const;
715     bool rareDataChildrenAffectedByDrag() const;
716     bool rareDataChildrenAffectedByFirstChildRules() const;
717     bool rareDataChildrenAffectedByLastChildRules() const;
718     bool rareDataChildrenAffectedByDirectAdjacentRules() const;
719     bool rareDataChildrenAffectedByForwardPositionalRules() const;
720     bool rareDataChildrenAffectedByBackwardPositionalRules() const;
721     unsigned rareDataChildIndex() const;
722
723     SpellcheckAttributeState spellcheckAttributeState() const;
724
725     void unregisterNamedFlowContentNode();
726
727     void createUniqueElementData();
728
729     ElementRareData* elementRareData() const;
730     ElementRareData* ensureElementRareData();
731
732     void detachAllAttrNodesFromElement();
733     void detachAttrNodeFromElementWithValue(Attr*, const AtomicString& value);
734
735     void createRendererIfNeeded();
736
737     bool isJavaScriptURLAttribute(const Attribute&) const;
738
739     RefPtr<ElementData> m_elementData;
740 };
741     
742 inline Element* toElement(Node* node)
743 {
744     ASSERT_WITH_SECURITY_IMPLICATION(!node || node->isElementNode());
745     return static_cast<Element*>(node);
746 }
747
748 inline const Element* toElement(const Node* node)
749 {
750     ASSERT_WITH_SECURITY_IMPLICATION(!node || node->isElementNode());
751     return static_cast<const Element*>(node);
752 }
753
754 // This will catch anyone doing an unnecessary cast.
755 void toElement(const Element*);
756
757 inline bool isDisabledFormControl(const Node* node)
758 {
759     return node->isElementNode() && toElement(node)->isDisabledFormControl();
760 }
761
762 inline bool Node::hasTagName(const QualifiedName& name) const
763 {
764     return isElementNode() && toElement(this)->hasTagName(name);
765 }
766     
767 inline bool Node::hasLocalName(const AtomicString& name) const
768 {
769     return isElementNode() && toElement(this)->hasLocalName(name);
770 }
771
772 inline bool Node::hasAttributes() const
773 {
774     return isElementNode() && toElement(this)->hasAttributes();
775 }
776
777 inline NamedNodeMap* Node::attributes() const
778 {
779     return isElementNode() ? toElement(this)->attributes() : 0;
780 }
781
782 inline Element* Node::parentElement() const
783 {
784     ContainerNode* parent = parentNode();
785     return parent && parent->isElementNode() ? toElement(parent) : 0;
786 }
787
788 inline Element* Element::previousElementSibling() const
789 {
790     Node* n = previousSibling();
791     while (n && !n->isElementNode())
792         n = n->previousSibling();
793     return static_cast<Element*>(n);
794 }
795
796 inline Element* Element::nextElementSibling() const
797 {
798     Node* n = nextSibling();
799     while (n && !n->isElementNode())
800         n = n->nextSibling();
801     return static_cast<Element*>(n);
802 }
803
804 inline bool Element::fastHasAttribute(const QualifiedName& name) const
805 {
806     ASSERT(fastAttributeLookupAllowed(name));
807     return elementData() && getAttributeItem(name);
808 }
809
810 inline const AtomicString& Element::fastGetAttribute(const QualifiedName& name) const
811 {
812     ASSERT(fastAttributeLookupAllowed(name));
813     if (elementData()) {
814         if (const Attribute* attribute = getAttributeItem(name))
815             return attribute->value();
816     }
817     return nullAtom;
818 }
819
820 inline bool Element::hasAttributesWithoutUpdate() const
821 {
822     return elementData() && !elementData()->isEmpty();
823 }
824
825 inline const AtomicString& Element::idForStyleResolution() const
826 {
827     ASSERT(hasID());
828     return elementData()->idForStyleResolution();
829 }
830
831 inline bool Element::isIdAttributeName(const QualifiedName& attributeName) const
832 {
833     // FIXME: This check is probably not correct for the case where the document has an id attribute
834     // with a non-null namespace, because it will return false, a false negative, if the prefixes
835     // don't match but the local name and namespace both do. However, since this has been like this
836     // for a while and the code paths may be hot, we'll have to measure performance if we fix it.
837     return attributeName == document()->idAttributeName();
838 }
839
840 inline const AtomicString& Element::getIdAttribute() const
841 {
842     return hasID() ? fastGetAttribute(document()->idAttributeName()) : nullAtom;
843 }
844
845 inline const AtomicString& Element::getNameAttribute() const
846 {
847     return hasName() ? fastGetAttribute(HTMLNames::nameAttr) : nullAtom;
848 }
849
850 inline void Element::setIdAttribute(const AtomicString& value)
851 {
852     setAttribute(document()->idAttributeName(), value);
853 }
854
855 inline const SpaceSplitString& Element::classNames() const
856 {
857     ASSERT(hasClass());
858     ASSERT(elementData());
859     return elementData()->classNames();
860 }
861
862 inline unsigned Element::attributeCount() const
863 {
864     ASSERT(elementData());
865     return elementData()->length();
866 }
867
868 inline const Attribute* Element::attributeItem(unsigned index) const
869 {
870     ASSERT(elementData());
871     return elementData()->attributeItem(index);
872 }
873
874 inline const Attribute* Element::getAttributeItem(const QualifiedName& name) const
875 {
876     ASSERT(elementData());
877     return elementData()->getAttributeItem(name);
878 }
879
880 inline bool Element::hasID() const
881 {
882     return elementData() && elementData()->hasID();
883 }
884
885 inline bool Element::hasClass() const
886 {
887     return elementData() && elementData()->hasClass();
888 }
889
890 inline UniqueElementData* Element::ensureUniqueElementData()
891 {
892     if (!elementData() || !elementData()->isUnique())
893         createUniqueElementData();
894     return static_cast<UniqueElementData*>(m_elementData.get());
895 }
896
897 // Put here to make them inline.
898 inline bool Node::hasID() const
899 {
900     return isElementNode() && toElement(this)->hasID();
901 }
902
903 inline bool Node::hasClass() const
904 {
905     return isElementNode() && toElement(this)->hasClass();
906 }
907
908 inline Node::InsertionNotificationRequest Node::insertedInto(ContainerNode* insertionPoint)
909 {
910     ASSERT(insertionPoint->inDocument() || isContainerNode());
911     if (insertionPoint->inDocument())
912         setFlag(InDocumentFlag);
913     if (parentOrShadowHostNode()->isInShadowTree())
914         setFlag(IsInShadowTreeFlag);
915     return InsertionDone;
916 }
917
918 inline void Node::removedFrom(ContainerNode* insertionPoint)
919 {
920     ASSERT(insertionPoint->inDocument() || isContainerNode());
921     if (insertionPoint->inDocument())
922         clearFlag(InDocumentFlag);
923     if (isInShadowTree() && !treeScope()->rootNode()->isShadowRoot())
924         clearFlag(IsInShadowTreeFlag);
925 }
926
927 inline bool isShadowHost(const Node* node)
928 {
929     return node && node->isElementNode() && toElement(node)->shadow();
930 }
931
932 inline unsigned ElementData::length() const
933 {
934     if (isUnique())
935         return static_cast<const UniqueElementData*>(this)->m_attributeVector.size();
936     return m_arraySize;
937 }
938
939 inline const Attribute* ElementData::attributeBase() const
940 {
941     if (m_isUnique)
942         return static_cast<const UniqueElementData*>(this)->m_attributeVector.data();
943     return static_cast<const ShareableElementData*>(this)->m_attributeArray;
944 }
945
946 inline const StylePropertySet* ElementData::presentationAttributeStyle() const
947 {
948     if (!m_isUnique)
949         return 0;
950     return static_cast<const UniqueElementData*>(this)->m_presentationAttributeStyle.get();
951 }
952
953 inline const Attribute* ElementData::getAttributeItem(const AtomicString& name, bool shouldIgnoreAttributeCase) const
954 {
955     unsigned index = getAttributeItemIndex(name, shouldIgnoreAttributeCase);
956     if (index != attributeNotFound)
957         return attributeItem(index);
958     return 0;
959 }
960
961 inline unsigned ElementData::getAttributeItemIndex(const QualifiedName& name) const
962 {
963     const Attribute* attributes = attributeBase();
964     for (unsigned i = 0, count = length(); i < count; ++i) {
965         if (attributes[i].name().matches(name))
966             return i;
967     }
968     return attributeNotFound;
969 }
970
971 // We use a boolean parameter instead of calling shouldIgnoreAttributeCase so that the caller
972 // can tune the behavior (hasAttribute is case sensitive whereas getAttribute is not).
973 inline unsigned ElementData::getAttributeItemIndex(const AtomicString& name, bool shouldIgnoreAttributeCase) const
974 {
975     const Attribute* attributes = attributeBase();
976     bool doSlowCheck = shouldIgnoreAttributeCase;
977     const AtomicString& caseAdjustedName = shouldIgnoreAttributeCase ? name.lower() : name;
978
979     // Optimize for the case where the attribute exists and its name exactly matches.
980     for (unsigned i = 0, count = length(); i < count; ++i) {
981         if (!attributes[i].name().hasPrefix()) {
982             if (caseAdjustedName == attributes[i].localName())
983                 return i;
984         } else
985             doSlowCheck = true;
986     }
987
988     if (doSlowCheck)
989         return getAttributeItemIndexSlowCase(name, shouldIgnoreAttributeCase);
990     return attributeNotFound;
991 }
992
993 inline const Attribute* ElementData::getAttributeItem(const QualifiedName& name) const
994 {
995     const Attribute* attributes = attributeBase();
996     for (unsigned i = 0, count = length(); i < count; ++i) {
997         if (attributes[i].name().matches(name))
998             return &attributes[i];
999     }
1000     return 0;
1001 }
1002
1003 inline const Attribute* ElementData::attributeItem(unsigned index) const
1004 {
1005     RELEASE_ASSERT(index < length());
1006     return attributeBase() + index;
1007 }
1008
1009 } // namespace
1010
1011 #endif