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