Ref-ify various getters that return HTMLCollection.
[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, 2014 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 "ElementData.h"
31 #include "HTMLNames.h"
32 #include "RegionOversetState.h"
33 #include "ScrollTypes.h"
34 #include "SimulatedClickOptions.h"
35 #include "StyleResolveTree.h"
36
37 namespace WebCore {
38
39 class ClientRect;
40 class ClientRectList;
41 class DatasetDOMStringMap;
42 class DOMTokenList;
43 class ElementRareData;
44 class HTMLDocument;
45 class IntSize;
46 class Locale;
47 class PlatformKeyboardEvent;
48 class PlatformMouseEvent;
49 class PlatformWheelEvent;
50 class PseudoElement;
51 class RenderNamedFlowFragment;
52 class ShadowRoot;
53
54 enum SpellcheckAttributeState {
55     SpellcheckAttributeTrue,
56     SpellcheckAttributeFalse,
57     SpellcheckAttributeDefault
58 };
59
60 class Element : public ContainerNode {
61 public:
62     static Ref<Element> create(const QualifiedName&, Document&);
63     virtual ~Element();
64
65     DEFINE_ATTRIBUTE_EVENT_LISTENER(abort);
66     DEFINE_ATTRIBUTE_EVENT_LISTENER(change);
67     DEFINE_ATTRIBUTE_EVENT_LISTENER(click);
68     DEFINE_ATTRIBUTE_EVENT_LISTENER(contextmenu);
69     DEFINE_ATTRIBUTE_EVENT_LISTENER(dblclick);
70     DEFINE_ATTRIBUTE_EVENT_LISTENER(dragenter);
71     DEFINE_ATTRIBUTE_EVENT_LISTENER(dragover);
72     DEFINE_ATTRIBUTE_EVENT_LISTENER(dragleave);
73     DEFINE_ATTRIBUTE_EVENT_LISTENER(drop);
74     DEFINE_ATTRIBUTE_EVENT_LISTENER(dragstart);
75     DEFINE_ATTRIBUTE_EVENT_LISTENER(drag);
76     DEFINE_ATTRIBUTE_EVENT_LISTENER(dragend);
77     DEFINE_ATTRIBUTE_EVENT_LISTENER(input);
78     DEFINE_ATTRIBUTE_EVENT_LISTENER(invalid);
79     DEFINE_ATTRIBUTE_EVENT_LISTENER(keydown);
80     DEFINE_ATTRIBUTE_EVENT_LISTENER(keypress);
81     DEFINE_ATTRIBUTE_EVENT_LISTENER(keyup);
82     DEFINE_ATTRIBUTE_EVENT_LISTENER(mousedown);
83     DEFINE_ATTRIBUTE_EVENT_LISTENER(mouseenter);
84     DEFINE_ATTRIBUTE_EVENT_LISTENER(mouseleave);
85     DEFINE_ATTRIBUTE_EVENT_LISTENER(mousemove);
86     DEFINE_ATTRIBUTE_EVENT_LISTENER(mouseout);
87     DEFINE_ATTRIBUTE_EVENT_LISTENER(mouseover);
88     DEFINE_ATTRIBUTE_EVENT_LISTENER(mouseup);
89     DEFINE_ATTRIBUTE_EVENT_LISTENER(mousewheel);
90     DEFINE_ATTRIBUTE_EVENT_LISTENER(scroll);
91     DEFINE_ATTRIBUTE_EVENT_LISTENER(select);
92     DEFINE_ATTRIBUTE_EVENT_LISTENER(submit);
93 #if ENABLE(WILL_REVEAL_EDGE_EVENTS)
94     DEFINE_ATTRIBUTE_EVENT_LISTENER(webkitwillrevealbottom);
95     DEFINE_ATTRIBUTE_EVENT_LISTENER(webkitwillrevealleft);
96     DEFINE_ATTRIBUTE_EVENT_LISTENER(webkitwillrevealright);
97     DEFINE_ATTRIBUTE_EVENT_LISTENER(webkitwillrevealtop);
98 #endif
99     DEFINE_ATTRIBUTE_EVENT_LISTENER(wheel);
100
101     // These four attribute event handler attributes are overridden by HTMLBodyElement
102     // and HTMLFrameSetElement to forward to the DOMWindow.
103     DECLARE_VIRTUAL_ATTRIBUTE_EVENT_LISTENER(blur);
104     DECLARE_VIRTUAL_ATTRIBUTE_EVENT_LISTENER(error);
105     DECLARE_VIRTUAL_ATTRIBUTE_EVENT_LISTENER(focus);
106     DECLARE_VIRTUAL_ATTRIBUTE_EVENT_LISTENER(load);
107
108     // WebKit extensions
109     DEFINE_ATTRIBUTE_EVENT_LISTENER(beforecut);
110     DEFINE_ATTRIBUTE_EVENT_LISTENER(cut);
111     DEFINE_ATTRIBUTE_EVENT_LISTENER(beforecopy);
112     DEFINE_ATTRIBUTE_EVENT_LISTENER(copy);
113     DEFINE_ATTRIBUTE_EVENT_LISTENER(beforepaste);
114     DEFINE_ATTRIBUTE_EVENT_LISTENER(paste);
115     DEFINE_ATTRIBUTE_EVENT_LISTENER(reset);
116     DEFINE_ATTRIBUTE_EVENT_LISTENER(search);
117     DEFINE_ATTRIBUTE_EVENT_LISTENER(selectstart);
118 #if ENABLE(TOUCH_EVENTS)
119     DEFINE_ATTRIBUTE_EVENT_LISTENER(touchstart);
120     DEFINE_ATTRIBUTE_EVENT_LISTENER(touchmove);
121     DEFINE_ATTRIBUTE_EVENT_LISTENER(touchend);
122     DEFINE_ATTRIBUTE_EVENT_LISTENER(touchcancel);
123 #endif
124 #if ENABLE(IOS_GESTURE_EVENTS)
125     DEFINE_ATTRIBUTE_EVENT_LISTENER(gesturestart);
126     DEFINE_ATTRIBUTE_EVENT_LISTENER(gesturechange);
127     DEFINE_ATTRIBUTE_EVENT_LISTENER(gestureend);
128 #endif
129 #if ENABLE(FULLSCREEN_API)
130     DEFINE_ATTRIBUTE_EVENT_LISTENER(webkitfullscreenchange);
131     DEFINE_ATTRIBUTE_EVENT_LISTENER(webkitfullscreenerror);
132 #endif
133
134     WEBCORE_EXPORT bool hasAttribute(const QualifiedName&) const;
135     WEBCORE_EXPORT const AtomicString& getAttribute(const QualifiedName&) const;
136     WEBCORE_EXPORT void setAttribute(const QualifiedName&, const AtomicString& value);
137     void setAttributeWithoutSynchronization(const QualifiedName&, const AtomicString& value);
138     void setSynchronizedLazyAttribute(const QualifiedName&, const AtomicString& value);
139     bool removeAttribute(const QualifiedName&);
140
141     // Typed getters and setters for language bindings.
142     int getIntegralAttribute(const QualifiedName& attributeName) const;
143     void setIntegralAttribute(const QualifiedName& attributeName, int value);
144     unsigned getUnsignedIntegralAttribute(const QualifiedName& attributeName) const;
145     void setUnsignedIntegralAttribute(const QualifiedName& attributeName, unsigned value);
146
147     // Call this to get the value of an attribute that is known not to be the style
148     // attribute or one of the SVG animatable attributes.
149     bool fastHasAttribute(const QualifiedName&) const;
150     const AtomicString& fastGetAttribute(const QualifiedName&) const;
151 #ifndef NDEBUG
152     WEBCORE_EXPORT bool fastAttributeLookupAllowed(const QualifiedName&) const;
153 #endif
154
155 #ifdef DUMP_NODE_STATISTICS
156     bool hasNamedNodeMap() const;
157 #endif
158     bool hasAttributes() const;
159     // This variant will not update the potentially invalid attributes. To be used when not interested
160     // in style attribute or one of the SVG animation attributes.
161     bool hasAttributesWithoutUpdate() const;
162
163     WEBCORE_EXPORT bool hasAttribute(const AtomicString& name) const;
164     bool hasAttributeNS(const AtomicString& namespaceURI, const AtomicString& localName) const;
165
166     WEBCORE_EXPORT const AtomicString& getAttribute(const AtomicString& name) const;
167     const AtomicString& getAttributeNS(const AtomicString& namespaceURI, const AtomicString& localName) const;
168
169     WEBCORE_EXPORT void setAttribute(const AtomicString& name, const AtomicString& value, ExceptionCode&);
170     static bool parseAttributeName(QualifiedName&, const AtomicString& namespaceURI, const AtomicString& qualifiedName, ExceptionCode&);
171     void setAttributeNS(const AtomicString& namespaceURI, const AtomicString& qualifiedName, const AtomicString& value, ExceptionCode&);
172
173     const AtomicString& getIdAttribute() const;
174     void setIdAttribute(const AtomicString&);
175
176     const AtomicString& getNameAttribute() const;
177
178     // Call this to get the value of the id attribute for style resolution purposes.
179     // The value will already be lowercased if the document is in compatibility mode,
180     // so this function is not suitable for non-style uses.
181     const AtomicString& idForStyleResolution() const;
182
183     // Internal methods that assume the existence of attribute storage, one should use hasAttributes()
184     // before calling them.
185     AttributeIteratorAccessor attributesIterator() const { return elementData()->attributesIterator(); }
186     unsigned attributeCount() const;
187     const Attribute& attributeAt(unsigned index) const;
188     const Attribute* findAttributeByName(const QualifiedName&) const;
189     unsigned findAttributeIndexByName(const QualifiedName& name) const { return elementData()->findAttributeIndexByName(name); }
190     unsigned findAttributeIndexByName(const AtomicString& name, bool shouldIgnoreAttributeCase) const { return elementData()->findAttributeIndexByName(name, shouldIgnoreAttributeCase); }
191
192     void scrollIntoView(bool alignToTop = true);
193     void scrollIntoViewIfNeeded(bool centerIfNeeded = true);
194
195     void scrollByLines(int lines);
196     void scrollByPages(int pages);
197
198     double offsetLeft();
199     double offsetTop();
200     double offsetWidth();
201     double offsetHeight();
202
203     bool mayCauseRepaintInsideViewport(const IntRect* visibleRect = nullptr) const;
204
205     // FIXME: Replace uses of offsetParent in the platform with calls
206     // to the render layer and merge bindingsOffsetParent and offsetParent.
207     Element* bindingsOffsetParent();
208
209     Element* offsetParent();
210     double clientLeft();
211     double clientTop();
212     double clientWidth();
213     double clientHeight();
214     virtual int scrollLeft();
215     virtual int scrollTop();
216     virtual void setScrollLeft(int);
217     virtual void setScrollTop(int);
218     virtual int scrollWidth();
219     virtual int scrollHeight();
220
221     WEBCORE_EXPORT IntRect boundsInRootViewSpace();
222
223     Ref<ClientRectList> getClientRects();
224     Ref<ClientRect> getBoundingClientRect();
225     
226     // Returns the absolute bounding box translated into client coordinates.
227     WEBCORE_EXPORT IntRect clientRect() const;
228     // Returns the absolute bounding box translated into screen coordinates.
229     WEBCORE_EXPORT IntRect screenRect() const;
230
231     bool removeAttribute(const AtomicString& name);
232     bool removeAttributeNS(const AtomicString& namespaceURI, const AtomicString& localName);
233
234     RefPtr<Attr> detachAttribute(unsigned index);
235
236     RefPtr<Attr> getAttributeNode(const AtomicString& name);
237     RefPtr<Attr> getAttributeNodeNS(const AtomicString& namespaceURI, const AtomicString& localName);
238     RefPtr<Attr> setAttributeNode(Attr*, ExceptionCode&);
239     RefPtr<Attr> setAttributeNodeNS(Attr*, ExceptionCode&);
240     RefPtr<Attr> removeAttributeNode(Attr*, ExceptionCode&);
241
242     RefPtr<Attr> attrIfExists(const QualifiedName&);
243     RefPtr<Attr> attrIfExists(const AtomicString& localName, bool shouldIgnoreAttributeCase);
244     RefPtr<Attr> ensureAttr(const QualifiedName&);
245
246     const Vector<RefPtr<Attr>>& attrNodeList();
247
248     virtual CSSStyleDeclaration* style();
249
250     const QualifiedName& tagQName() const { return m_tagName; }
251 #if ENABLE(CSS_SELECTOR_JIT)
252     static ptrdiff_t tagQNameMemoryOffset() { return OBJECT_OFFSETOF(Element, m_tagName); }
253 #endif // ENABLE(CSS_SELECTOR_JIT)
254     String tagName() const { return nodeName(); }
255     bool hasTagName(const QualifiedName& tagName) const { return m_tagName.matches(tagName); }
256     bool hasTagName(const HTMLQualifiedName& tagName) const { return ContainerNode::hasTagName(tagName); }
257     bool hasTagName(const MathMLQualifiedName& tagName) const { return ContainerNode::hasTagName(tagName); }
258     bool hasTagName(const SVGQualifiedName& tagName) const { return ContainerNode::hasTagName(tagName); }
259
260     // A fast function for checking the local name against another atomic string.
261     bool hasLocalName(const AtomicString& other) const { return m_tagName.localName() == other; }
262
263     virtual const AtomicString& localName() const override final { return m_tagName.localName(); }
264     virtual const AtomicString& prefix() const override final { return m_tagName.prefix(); }
265     virtual const AtomicString& namespaceURI() const override final { return m_tagName.namespaceURI(); }
266
267     virtual URL baseURI() const override final;
268
269     virtual String nodeName() const override;
270
271     RefPtr<Element> cloneElementWithChildren(Document&);
272     RefPtr<Element> cloneElementWithoutChildren(Document&);
273
274     void normalizeAttributes();
275     String nodeNamePreservingCase() const;
276
277     void setBooleanAttribute(const QualifiedName& name, bool);
278
279     // For exposing to DOM only.
280     NamedNodeMap& attributes() const;
281
282     enum AttributeModificationReason {
283         ModifiedDirectly,
284         ModifiedByCloning
285     };
286
287     // This method is called whenever an attribute is added, changed or removed.
288     virtual void attributeChanged(const QualifiedName&, const AtomicString& oldValue, const AtomicString& newValue, AttributeModificationReason = ModifiedDirectly);
289     virtual void parseAttribute(const QualifiedName&, const AtomicString&) { }
290
291     // Only called by the parser immediately after element construction.
292     void parserSetAttributes(const Vector<Attribute>&);
293
294     // Remove attributes that might introduce scripting from the vector leaving the element unchanged.
295     void stripScriptingAttributes(Vector<Attribute>&) const;
296
297     const ElementData* elementData() const { return m_elementData.get(); }
298     static ptrdiff_t elementDataMemoryOffset() { return OBJECT_OFFSETOF(Element, m_elementData); }
299     UniqueElementData& ensureUniqueElementData();
300
301     void synchronizeAllAttributes() const;
302
303     // Clones attributes only.
304     void cloneAttributesFromElement(const Element&);
305
306     // Clones all attribute-derived data, including subclass specifics (through copyNonAttributeProperties.)
307     void cloneDataFromElement(const Element&);
308
309     bool hasEquivalentAttributes(const Element* other) const;
310
311     virtual void copyNonAttributePropertiesFromElement(const Element&) { }
312
313     void lazyReattach();
314
315     virtual RenderPtr<RenderElement> createElementRenderer(Ref<RenderStyle>&&);
316     virtual bool rendererIsNeeded(const RenderStyle&);
317
318     WEBCORE_EXPORT ShadowRoot* shadowRoot() const;
319     WEBCORE_EXPORT RefPtr<ShadowRoot> createShadowRoot(ExceptionCode&);
320
321     ShadowRoot* userAgentShadowRoot() const;
322     ShadowRoot& ensureUserAgentShadowRoot();
323
324     // FIXME: this should not be virtual, do not override this.
325     virtual const AtomicString& shadowPseudoId() const;
326
327     bool inActiveChain() const { return isUserActionElement() && isUserActionElementInActiveChain(); }
328     bool active() const { return isUserActionElement() && isUserActionElementActive(); }
329     bool hovered() const { return isUserActionElement() && isUserActionElementHovered(); }
330     bool focused() const { return isUserActionElement() && isUserActionElementFocused(); }
331
332     virtual void setActive(bool flag = true, bool pause = false);
333     virtual void setHovered(bool flag = true);
334     virtual void setFocus(bool flag);
335
336     virtual bool supportsFocus() const;
337     virtual bool isFocusable() const;
338     virtual bool isKeyboardFocusable(KeyboardEvent*) const;
339     virtual bool isMouseFocusable() const;
340
341     virtual bool shouldUseInputMethod();
342
343     virtual short tabIndex() const;
344     void setTabIndex(int);
345     virtual Element* focusDelegate();
346
347     virtual RenderStyle* computedStyle(PseudoId = NOPSEUDO) override;
348
349     // Methods for indicating the style is affected by dynamic updates (e.g., children changing, our position changing in our sibling list, etc.)
350     bool styleAffectedByEmpty() const { return hasRareData() && rareDataStyleAffectedByEmpty(); }
351     bool childrenAffectedByHover() const { return getFlag(ChildrenAffectedByHoverRulesFlag); }
352     bool childrenAffectedByActive() const { return hasRareData() && rareDataChildrenAffectedByActive(); }
353     bool childrenAffectedByDrag() const { return hasRareData() && rareDataChildrenAffectedByDrag(); }
354     bool childrenAffectedByFirstChildRules() const { return getFlag(ChildrenAffectedByFirstChildRulesFlag); }
355     bool childrenAffectedByLastChildRules() const { return getFlag(ChildrenAffectedByLastChildRulesFlag); }
356     bool childrenAffectedByBackwardPositionalRules() const { return hasRareData() && rareDataChildrenAffectedByBackwardPositionalRules(); }
357     bool childrenAffectedByPropertyBasedBackwardPositionalRules() const { return hasRareData() && rareDataChildrenAffectedByPropertyBasedBackwardPositionalRules(); }
358     bool affectsNextSiblingElementStyle() const { return getFlag(AffectsNextSiblingElementStyle); }
359     unsigned childIndex() const { return hasRareData() ? rareDataChildIndex() : 0; }
360
361     bool hasFlagsSetDuringStylingOfChildren() const;
362
363     void setStyleAffectedByEmpty();
364     void setChildrenAffectedByHover() { setFlag(ChildrenAffectedByHoverRulesFlag); }
365     void setChildrenAffectedByActive();
366     void setChildrenAffectedByDrag();
367     void setChildrenAffectedByFirstChildRules() { setFlag(ChildrenAffectedByFirstChildRulesFlag); }
368     void setChildrenAffectedByLastChildRules() { setFlag(ChildrenAffectedByLastChildRulesFlag); }
369     void setChildrenAffectedByBackwardPositionalRules();
370     void setChildrenAffectedByPropertyBasedBackwardPositionalRules();
371     void setAffectsNextSiblingElementStyle() { setFlag(AffectsNextSiblingElementStyle); }
372     void setStyleIsAffectedByPreviousSibling() { setFlag(StyleIsAffectedByPreviousSibling); }
373     void setChildIndex(unsigned);
374
375     void setRegionOversetState(RegionOversetState);
376     RegionOversetState regionOversetState() const;
377
378     AtomicString computeInheritedLanguage() const;
379     Locale& locale() const;
380
381     virtual void accessKeyAction(bool /*sendToAnyEvent*/) { }
382
383     virtual bool isURLAttribute(const Attribute&) const { return false; }
384     virtual bool attributeContainsURL(const Attribute& attribute) const { return isURLAttribute(attribute); }
385     virtual String completeURLsInAttributeValue(const URL& base, const Attribute&) const;
386     virtual bool isHTMLContentAttribute(const Attribute&) const { return false; }
387
388     WEBCORE_EXPORT URL getURLAttribute(const QualifiedName&) const;
389     URL getNonEmptyURLAttribute(const QualifiedName&) const;
390
391     virtual const AtomicString& imageSourceURL() const;
392     virtual String target() const { return String(); }
393
394     void updateFocusAppearanceAfterAttachIfNeeded();
395     virtual void focus(bool restorePreviousSelection = true, FocusDirection = FocusDirectionNone);
396     virtual void updateFocusAppearance(bool restorePreviousSelection);
397     virtual void blur();
398
399     String innerHTML() const;
400     String outerHTML() const;
401     void setInnerHTML(const String&, ExceptionCode&);
402     void setOuterHTML(const String&, ExceptionCode&);
403     WEBCORE_EXPORT String innerText();
404     String outerText();
405  
406     virtual String title() const;
407
408     const AtomicString& pseudo() const;
409     WEBCORE_EXPORT void setPseudo(const AtomicString&);
410
411     LayoutSize minimumSizeForResizing() const;
412     void setMinimumSizeForResizing(const LayoutSize&);
413
414     // Use Document::registerForDocumentActivationCallbacks() to subscribe to these
415     virtual void documentWillSuspendForPageCache() { }
416     virtual void documentDidResumeFromPageCache() { }
417
418     // Use Document::registerForMediaVolumeCallbacks() to subscribe to this
419     virtual void mediaVolumeDidChange() { }
420
421     // Use Document::registerForPrivateBrowsingStateChangedCallbacks() to subscribe to this.
422     virtual void privateBrowsingStateDidChange() { }
423
424     virtual void didBecomeFullscreenElement() { }
425     virtual void willStopBeingFullscreenElement() { }
426
427     // Use Document::registerForVisibilityStateChangedCallbacks() to subscribe to this.
428     virtual void visibilityStateChanged() { }
429
430 #if ENABLE(VIDEO_TRACK)
431     virtual void captionPreferencesChanged() { }
432 #endif
433
434     bool isFinishedParsingChildren() const { return isParsingChildrenFinished(); }
435     virtual void finishParsingChildren() override;
436     virtual void beginParsingChildren() override final;
437
438     WEBCORE_EXPORT PseudoElement* beforePseudoElement() const;
439     WEBCORE_EXPORT PseudoElement* afterPseudoElement() const;
440     bool childNeedsShadowWalker() const;
441     void didShadowTreeAwareChildrenChange();
442
443     // ElementTraversal API
444     Element* firstElementChild() const;
445     Element* lastElementChild() const;
446     Element* previousElementSibling() const;
447     Element* nextElementSibling() const;
448     unsigned childElementCount() const;
449
450     virtual bool matchesReadWritePseudoClass() const;
451     bool matches(const String& selectors, ExceptionCode&);
452     Element* closest(const String& selectors, ExceptionCode&);
453     virtual bool shouldAppearIndeterminate() const;
454
455     DOMTokenList& classList();
456
457     DatasetDOMStringMap& dataset();
458
459 #if ENABLE(VIDEO)
460     virtual bool isMediaElement() const { return false; }
461 #endif
462
463     virtual bool matchesValidPseudoClass() const { return false; }
464     virtual bool matchesInvalidPseudoClass() const { return false; }
465     virtual bool isFormControlElement() const { return false; }
466     virtual bool isSpinButtonElement() const { return false; }
467     virtual bool isTextFormControl() const { return false; }
468     virtual bool isOptionalFormControl() const { return false; }
469     virtual bool isRequiredFormControl() const { return false; }
470     virtual bool isDefaultButtonForForm() const { return false; }
471     virtual bool isInRange() const { return false; }
472     virtual bool isOutOfRange() const { return false; }
473     virtual bool isFrameElementBase() const { return false; }
474     virtual bool isSearchFieldCancelButtonElement() const { return false; }
475
476     virtual bool canContainRangeEndPoint() const override;
477
478     // Used for disabled form elements; if true, prevents mouse events from being dispatched
479     // to event listeners, and prevents DOMActivate events from being sent at all.
480     virtual bool isDisabledFormControl() const { return false; }
481
482     virtual bool childShouldCreateRenderer(const Node&) const;
483
484     bool hasPendingResources() const;
485     void setHasPendingResources();
486     void clearHasPendingResources();
487     virtual void buildPendingResource() { };
488
489 #if ENABLE(FULLSCREEN_API)
490     enum {
491         ALLOW_KEYBOARD_INPUT = 1 << 0,
492         LEGACY_MOZILLA_REQUEST = 1 << 1,
493     };
494     
495     void webkitRequestFullScreen(unsigned short flags);
496     WEBCORE_EXPORT bool containsFullScreenElement() const;
497     void setContainsFullScreenElement(bool);
498     void setContainsFullScreenElementOnAncestorsCrossingFrameBoundaries(bool);
499
500     // W3C API
501     void webkitRequestFullscreen();
502 #endif
503
504 #if ENABLE(POINTER_LOCK)
505     void requestPointerLock();
506 #endif
507
508 #if ENABLE(INDIE_UI)
509     void setUIActions(const AtomicString&);
510     const AtomicString& UIActions() const;
511 #endif
512     
513     virtual bool isSpellCheckingEnabled() const;
514
515     RenderNamedFlowFragment* renderNamedFlowFragment() const;
516
517 #if ENABLE(CSS_REGIONS)
518     virtual bool shouldMoveToFlowThread(const RenderStyle&) const;
519     
520     const AtomicString& webkitRegionOverset() const;
521     Vector<RefPtr<Range>> webkitGetRegionFlowRanges() const;
522 #endif
523
524     bool hasID() const;
525     bool hasClass() const;
526     bool hasName() const;
527     const SpaceSplitString& classNames() const;
528
529     IntSize savedLayerScrollOffset() const;
530     void setSavedLayerScrollOffset(const IntSize&);
531
532     bool dispatchMouseEvent(const PlatformMouseEvent&, const AtomicString& eventType, int clickCount = 0, Element* relatedTarget = nullptr);
533     bool dispatchWheelEvent(const PlatformWheelEvent&);
534     bool dispatchKeyEvent(const PlatformKeyboardEvent&);
535     void dispatchSimulatedClick(Event* underlyingEvent, SimulatedClickMouseEventOptions = SendNoEvents, SimulatedClickVisualOptions = ShowPressedLook);
536     void dispatchFocusInEvent(const AtomicString& eventType, RefPtr<Element>&& oldFocusedElement);
537     void dispatchFocusOutEvent(const AtomicString& eventType, RefPtr<Element>&& newFocusedElement);
538     virtual void dispatchFocusEvent(RefPtr<Element>&& oldFocusedElement, FocusDirection);
539     virtual void dispatchBlurEvent(RefPtr<Element>&& newFocusedElement);
540
541     virtual bool willRecalcStyle(Style::Change);
542     virtual void didRecalcStyle(Style::Change);
543     virtual void willResetComputedStyle();
544     virtual void willAttachRenderers();
545     virtual void didAttachRenderers();
546     virtual void willDetachRenderers();
547     virtual void didDetachRenderers();
548     virtual RefPtr<RenderStyle> customStyleForRenderer(RenderStyle& parentStyle);
549
550     void setBeforePseudoElement(Ref<PseudoElement>&&);
551     void setAfterPseudoElement(Ref<PseudoElement>&&);
552     void clearBeforePseudoElement();
553     void clearAfterPseudoElement();
554     void resetComputedStyle();
555     void clearStyleDerivedDataBeforeDetachingRenderer();
556     void clearHoverAndActiveStatusBeforeDetachingRenderer();
557
558     WEBCORE_EXPORT URL absoluteLinkURL() const;
559     WeakPtr<Element> createWeakPtr();
560
561 protected:
562     Element(const QualifiedName&, Document&, ConstructionType);
563
564     virtual InsertionNotificationRequest insertedInto(ContainerNode&) override;
565     virtual void removedFrom(ContainerNode&) override;
566     virtual void childrenChanged(const ChildChange&) override;
567     virtual void removeAllEventListeners() override final;
568     virtual void parserDidSetAttributes();
569
570     void clearTabIndexExplicitlyIfNeeded();
571     void setTabIndexExplicitly(short);
572
573     Ref<HTMLCollection> ensureCachedHTMLCollection(CollectionType);
574     HTMLCollection* cachedHTMLCollection(CollectionType);
575
576     // classAttributeChanged() exists to share code between
577     // parseAttribute (called via setAttribute()) and
578     // svgAttributeChanged (called when element.className.baseValue is set)
579     void classAttributeChanged(const AtomicString& newClassString);
580
581     static void mergeWithNextTextNode(Text& node, ExceptionCode&);
582
583 private:
584     bool isTextNode() const;
585
586     bool isUserActionElementInActiveChain() const;
587     bool isUserActionElementActive() const;
588     bool isUserActionElementFocused() const;
589     bool isUserActionElementHovered() const;
590
591     void resetNeedsNodeRenderingTraversalSlowPath();
592
593     virtual void didAddUserAgentShadowRoot(ShadowRoot*) { }
594     virtual bool alwaysCreateUserAgentShadowRoot() const { return false; }
595
596     // FIXME: Remove the need for Attr to call willModifyAttribute/didModifyAttribute.
597     friend class Attr;
598
599     enum SynchronizationOfLazyAttribute { NotInSynchronizationOfLazyAttribute = 0, InSynchronizationOfLazyAttribute };
600
601     void didAddAttribute(const QualifiedName&, const AtomicString&);
602     void willModifyAttribute(const QualifiedName&, const AtomicString& oldValue, const AtomicString& newValue);
603     void didModifyAttribute(const QualifiedName&, const AtomicString& oldValue, const AtomicString& newValue);
604     void didRemoveAttribute(const QualifiedName&, const AtomicString& oldValue);
605
606     void synchronizeAttribute(const QualifiedName&) const;
607     void synchronizeAttribute(const AtomicString& localName) const;
608
609     void updateName(const AtomicString& oldName, const AtomicString& newName);
610     void updateNameForTreeScope(TreeScope&, const AtomicString& oldName, const AtomicString& newName);
611     void updateNameForDocument(HTMLDocument&, const AtomicString& oldName, const AtomicString& newName);
612     void updateId(const AtomicString& oldId, const AtomicString& newId);
613     void updateIdForTreeScope(TreeScope&, const AtomicString& oldId, const AtomicString& newId);
614     enum HTMLDocumentNamedItemMapsUpdatingCondition { AlwaysUpdateHTMLDocumentNamedItemMaps, UpdateHTMLDocumentNamedItemMapsOnlyIfDiffersFromNameAttribute };
615     void updateIdForDocument(HTMLDocument&, const AtomicString& oldId, const AtomicString& newId, HTMLDocumentNamedItemMapsUpdatingCondition);
616     void updateLabel(TreeScope&, const AtomicString& oldForAttributeValue, const AtomicString& newForAttributeValue);
617
618     void scrollByUnits(int units, ScrollGranularity);
619
620     virtual void setPrefix(const AtomicString&, ExceptionCode&) override final;
621     virtual NodeType nodeType() const override final;
622     virtual bool childTypeAllowed(NodeType) const override final;
623
624     void setAttributeInternal(unsigned index, const QualifiedName&, const AtomicString& value, SynchronizationOfLazyAttribute);
625     void addAttributeInternal(const QualifiedName&, const AtomicString& value, SynchronizationOfLazyAttribute);
626     void removeAttributeInternal(unsigned index, SynchronizationOfLazyAttribute);
627
628 #ifndef NDEBUG
629     virtual void formatForDebugger(char* buffer, unsigned length) const override;
630 #endif
631
632     void cancelFocusAppearanceUpdate();
633
634     // cloneNode is private so that non-virtual cloneElementWithChildren and cloneElementWithoutChildren
635     // are used instead.
636     virtual RefPtr<Node> cloneNodeInternal(Document&, CloningOperation) override;
637     virtual RefPtr<Element> cloneElementWithoutAttributesAndChildren(Document&);
638
639     void addShadowRoot(Ref<ShadowRoot>&&);
640     void removeShadowRoot();
641
642     bool rareDataStyleAffectedByEmpty() const;
643     bool rareDataChildrenAffectedByHover() const;
644     bool rareDataChildrenAffectedByActive() const;
645     bool rareDataChildrenAffectedByDrag() const;
646     bool rareDataChildrenAffectedByLastChildRules() const;
647     bool rareDataChildrenAffectedByBackwardPositionalRules() const;
648     bool rareDataChildrenAffectedByPropertyBasedBackwardPositionalRules() const;
649     unsigned rareDataChildIndex() const;
650
651     SpellcheckAttributeState spellcheckAttributeState() const;
652
653     void unregisterNamedFlowContentElement();
654
655     void createUniqueElementData();
656
657     ElementRareData* elementRareData() const;
658     ElementRareData& ensureElementRareData();
659
660     void detachAllAttrNodesFromElement();
661     void detachAttrNodeFromElementWithValue(Attr*, const AtomicString& value);
662
663     bool isJavaScriptURLAttribute(const Attribute&) const;
664
665     // Anyone thinking of using this should call document instead of ownerDocument.
666     void ownerDocument() const = delete;
667
668     QualifiedName m_tagName;
669     RefPtr<ElementData> m_elementData;
670 };
671
672 inline bool Node::hasAttributes() const
673 {
674     return is<Element>(*this) && downcast<Element>(*this).hasAttributes();
675 }
676
677 inline NamedNodeMap* Node::attributes() const
678 {
679     return is<Element>(*this) ? &downcast<Element>(*this).attributes() : nullptr;
680 }
681
682 inline Element* Node::parentElement() const
683 {
684     ContainerNode* parent = parentNode();
685     return is<Element>(parent) ? downcast<Element>(parent) : nullptr;
686 }
687
688 inline bool Element::fastHasAttribute(const QualifiedName& name) const
689 {
690     ASSERT(fastAttributeLookupAllowed(name));
691     return elementData() && findAttributeByName(name);
692 }
693
694 inline const AtomicString& Element::fastGetAttribute(const QualifiedName& name) const
695 {
696     ASSERT(fastAttributeLookupAllowed(name));
697     if (elementData()) {
698         if (const Attribute* attribute = findAttributeByName(name))
699             return attribute->value();
700     }
701     return nullAtom;
702 }
703
704 inline bool Element::hasAttributesWithoutUpdate() const
705 {
706     return elementData() && !elementData()->isEmpty();
707 }
708
709 inline const AtomicString& Element::idForStyleResolution() const
710 {
711     ASSERT(hasID());
712     return elementData()->idForStyleResolution();
713 }
714
715 inline const AtomicString& Element::getIdAttribute() const
716 {
717     if (hasID())
718         return elementData()->findAttributeByName(HTMLNames::idAttr)->value();
719     return nullAtom;
720 }
721
722 inline const AtomicString& Element::getNameAttribute() const
723 {
724     if (hasName())
725         return elementData()->findAttributeByName(HTMLNames::nameAttr)->value();
726     return nullAtom;
727 }
728
729 inline void Element::setIdAttribute(const AtomicString& value)
730 {
731     setAttribute(HTMLNames::idAttr, value);
732 }
733
734 inline const SpaceSplitString& Element::classNames() const
735 {
736     ASSERT(hasClass());
737     ASSERT(elementData());
738     return elementData()->classNames();
739 }
740
741 inline unsigned Element::attributeCount() const
742 {
743     ASSERT(elementData());
744     return elementData()->length();
745 }
746
747 inline const Attribute& Element::attributeAt(unsigned index) const
748 {
749     ASSERT(elementData());
750     return elementData()->attributeAt(index);
751 }
752
753 inline const Attribute* Element::findAttributeByName(const QualifiedName& name) const
754 {
755     ASSERT(elementData());
756     return elementData()->findAttributeByName(name);
757 }
758
759 inline bool Element::hasID() const
760 {
761     return elementData() && elementData()->hasID();
762 }
763
764 inline bool Element::hasClass() const
765 {
766     return elementData() && elementData()->hasClass();
767 }
768
769 inline bool Element::hasName() const
770 {
771     return elementData() && elementData()->hasName();
772 }
773
774 inline UniqueElementData& Element::ensureUniqueElementData()
775 {
776     if (!elementData() || !elementData()->isUnique())
777         createUniqueElementData();
778     return static_cast<UniqueElementData&>(*m_elementData);
779 }
780
781 } // namespace WebCore
782
783 SPECIALIZE_TYPE_TRAITS_BEGIN(WebCore::Element)
784     static bool isType(const WebCore::Node& node) { return node.isElementNode(); }
785 SPECIALIZE_TYPE_TRAITS_END()
786
787 #endif