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