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