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