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