[WTF] Clean up StringStatics.cpp by using LazyNeverDestroyed<> for Atoms
[WebKit-https.git] / Source / WebCore / dom / Element.cpp
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  *           (C) 2007 David Smith (catfish.man@gmail.com)
7  * Copyright (C) 2004-2017 Apple Inc. All rights reserved.
8  *           (C) 2007 Eric Seidel (eric@webkit.org)
9  *
10  * This library is free software; you can redistribute it and/or
11  * modify it under the terms of the GNU Library General Public
12  * License as published by the Free Software Foundation; either
13  * version 2 of the License, or (at your option) any later version.
14  *
15  * This library is distributed in the hope that it will be useful,
16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
18  * Library General Public License for more details.
19  *
20  * You should have received a copy of the GNU Library General Public License
21  * along with this library; see the file COPYING.LIB.  If not, write to
22  * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
23  * Boston, MA 02110-1301, USA.
24  */
25
26 #include "config.h"
27 #include "Element.h"
28
29 #include "AXObjectCache.h"
30 #include "Attr.h"
31 #include "AttributeChangeInvalidation.h"
32 #include "CSSParser.h"
33 #include "Chrome.h"
34 #include "ChromeClient.h"
35 #include "ClassChangeInvalidation.h"
36 #include "ComposedTreeAncestorIterator.h"
37 #include "ContainerNodeAlgorithms.h"
38 #include "CustomElementReactionQueue.h"
39 #include "CustomElementRegistry.h"
40 #include "DOMRect.h"
41 #include "DOMRectList.h"
42 #include "DOMTokenList.h"
43 #include "DocumentAnimation.h"
44 #include "DocumentSharedObjectPool.h"
45 #include "Editing.h"
46 #include "ElementIterator.h"
47 #include "ElementRareData.h"
48 #include "EventDispatcher.h"
49 #include "EventHandler.h"
50 #include "EventNames.h"
51 #include "FlowThreadController.h"
52 #include "FocusController.h"
53 #include "FocusEvent.h"
54 #include "FrameSelection.h"
55 #include "FrameView.h"
56 #include "HTMLBodyElement.h"
57 #include "HTMLCanvasElement.h"
58 #include "HTMLCollection.h"
59 #include "HTMLDocument.h"
60 #include "HTMLHtmlElement.h"
61 #include "HTMLLabelElement.h"
62 #include "HTMLNameCollection.h"
63 #include "HTMLObjectElement.h"
64 #include "HTMLParserIdioms.h"
65 #include "HTMLTemplateElement.h"
66 #include "IdChangeInvalidation.h"
67 #include "IdTargetObserverRegistry.h"
68 #include "InspectorInstrumentation.h"
69 #include "JSLazyEventListener.h"
70 #include "KeyboardEvent.h"
71 #include "KeyframeEffect.h"
72 #include "MainFrame.h"
73 #include "MutationObserverInterestGroup.h"
74 #include "MutationRecord.h"
75 #include "NoEventDispatchAssertion.h"
76 #include "NodeRenderStyle.h"
77 #include "PlatformWheelEvent.h"
78 #include "PointerLockController.h"
79 #include "RenderFlowThread.h"
80 #include "RenderLayer.h"
81 #include "RenderNamedFlowFragment.h"
82 #include "RenderRegion.h"
83 #include "RenderTheme.h"
84 #include "RenderTreeUpdater.h"
85 #include "RenderView.h"
86 #include "RenderWidget.h"
87 #include "SVGDocumentExtensions.h"
88 #include "SVGElement.h"
89 #include "SVGNames.h"
90 #include "SVGSVGElement.h"
91 #include "ScrollLatchingState.h"
92 #include "SelectorQuery.h"
93 #include "Settings.h"
94 #include "SimulatedClick.h"
95 #include "SlotAssignment.h"
96 #include "StyleProperties.h"
97 #include "StyleResolver.h"
98 #include "StyleScope.h"
99 #include "StyleTreeResolver.h"
100 #include "TextIterator.h"
101 #include "VoidCallback.h"
102 #include "WheelEvent.h"
103 #include "XLinkNames.h"
104 #include "XMLNSNames.h"
105 #include "XMLNames.h"
106 #include "markup.h"
107 #include <wtf/CurrentTime.h>
108 #include <wtf/NeverDestroyed.h>
109 #include <wtf/text/CString.h>
110
111 namespace WebCore {
112
113 using namespace HTMLNames;
114 using namespace XMLNames;
115
116 static HashMap<Element*, Vector<RefPtr<Attr>>>& attrNodeListMap()
117 {
118     static NeverDestroyed<HashMap<Element*, Vector<RefPtr<Attr>>>> map;
119     return map;
120 }
121
122 static Vector<RefPtr<Attr>>* attrNodeListForElement(Element& element)
123 {
124     if (!element.hasSyntheticAttrChildNodes())
125         return nullptr;
126     ASSERT(attrNodeListMap().contains(&element));
127     return &attrNodeListMap().find(&element)->value;
128 }
129
130 static Vector<RefPtr<Attr>>& ensureAttrNodeListForElement(Element& element)
131 {
132     if (element.hasSyntheticAttrChildNodes()) {
133         ASSERT(attrNodeListMap().contains(&element));
134         return attrNodeListMap().find(&element)->value;
135     }
136     ASSERT(!attrNodeListMap().contains(&element));
137     element.setHasSyntheticAttrChildNodes(true);
138     return attrNodeListMap().add(&element, Vector<RefPtr<Attr>>()).iterator->value;
139 }
140
141 static void removeAttrNodeListForElement(Element& element)
142 {
143     ASSERT(element.hasSyntheticAttrChildNodes());
144     ASSERT(attrNodeListMap().contains(&element));
145     attrNodeListMap().remove(&element);
146     element.setHasSyntheticAttrChildNodes(false);
147 }
148
149 static Attr* findAttrNodeInList(Vector<RefPtr<Attr>>& attrNodeList, const QualifiedName& name)
150 {
151     for (auto& node : attrNodeList) {
152         if (node->qualifiedName().matches(name))
153             return node.get();
154     }
155     return nullptr;
156 }
157
158 static Attr* findAttrNodeInList(Vector<RefPtr<Attr>>& attrNodeList, const AtomicString& localName, bool shouldIgnoreAttributeCase)
159 {
160     const AtomicString& caseAdjustedName = shouldIgnoreAttributeCase ? localName.convertToASCIILowercase() : localName;
161     for (auto& node : attrNodeList) {
162         if (node->qualifiedName().localName() == caseAdjustedName)
163             return node.get();
164     }
165     return nullptr;
166 }
167
168 Ref<Element> Element::create(const QualifiedName& tagName, Document& document)
169 {
170     return adoptRef(*new Element(tagName, document, CreateElement));
171 }
172
173 Element::Element(const QualifiedName& tagName, Document& document, ConstructionType type)
174     : ContainerNode(document, type)
175     , m_tagName(tagName)
176 {
177 }
178
179 Element::~Element()
180 {
181 #ifndef NDEBUG
182     if (document().hasLivingRenderTree()) {
183         // When the document is not destroyed, an element that was part of a named flow
184         // content nodes should have been removed from the content nodes collection
185         // and the isNamedFlowContentElement flag reset.
186         ASSERT_WITH_SECURITY_IMPLICATION(!isNamedFlowContentElement());
187     }
188 #endif
189
190     ASSERT(!beforePseudoElement());
191     ASSERT(!afterPseudoElement());
192
193     removeShadowRoot();
194
195     if (hasSyntheticAttrChildNodes())
196         detachAllAttrNodesFromElement();
197
198     if (hasPendingResources()) {
199         document().accessSVGExtensions().removeElementFromPendingResources(this);
200         ASSERT(!hasPendingResources());
201     }
202 }
203
204 inline ElementRareData* Element::elementRareData() const
205 {
206     ASSERT_WITH_SECURITY_IMPLICATION(hasRareData());
207     return static_cast<ElementRareData*>(rareData());
208 }
209
210 inline ElementRareData& Element::ensureElementRareData()
211 {
212     return static_cast<ElementRareData&>(ensureRareData());
213 }
214
215 void Element::clearTabIndexExplicitlyIfNeeded()
216 {
217     if (hasRareData())
218         elementRareData()->clearTabIndexExplicitly();
219 }
220
221 void Element::setTabIndexExplicitly(int tabIndex)
222 {
223     ensureElementRareData().setTabIndexExplicitly(tabIndex);
224 }
225
226 bool Element::tabIndexSetExplicitly() const
227 {
228     return hasRareData() && elementRareData()->tabIndexSetExplicitly();
229 }
230
231 bool Element::supportsFocus() const
232 {
233     return tabIndexSetExplicitly();
234 }
235
236 Element* Element::focusDelegate()
237 {
238     return this;
239 }
240
241 int Element::tabIndex() const
242 {
243     return hasRareData() ? elementRareData()->tabIndex() : 0;
244 }
245
246 void Element::setTabIndex(int value)
247 {
248     setIntegralAttribute(tabindexAttr, value);
249 }
250
251 bool Element::isKeyboardFocusable(KeyboardEvent&) const
252 {
253     return isFocusable() && tabIndex() >= 0;
254 }
255
256 bool Element::isMouseFocusable() const
257 {
258     return isFocusable();
259 }
260
261 bool Element::shouldUseInputMethod()
262 {
263     return computeEditability(UserSelectAllIsAlwaysNonEditable, ShouldUpdateStyle::Update) != Editability::ReadOnly;
264 }
265
266 static bool isForceEvent(const PlatformMouseEvent& platformEvent)
267 {
268     return platformEvent.type() == PlatformEvent::MouseForceChanged || platformEvent.type() == PlatformEvent::MouseForceDown || platformEvent.type() == PlatformEvent::MouseForceUp;
269 }
270
271 bool Element::dispatchMouseEvent(const PlatformMouseEvent& platformEvent, const AtomicString& eventType, int detail, Element* relatedTarget)
272 {
273     if (isDisabledFormControl())
274         return false;
275
276     if (isForceEvent(platformEvent) && !document().hasListenerTypeForEventType(platformEvent.type()))
277         return false;
278
279     Ref<MouseEvent> mouseEvent = MouseEvent::create(eventType, document().defaultView(), platformEvent, detail, relatedTarget);
280
281     if (mouseEvent->type().isEmpty())
282         return true; // Shouldn't happen.
283
284     ASSERT(!mouseEvent->target() || mouseEvent->target() != relatedTarget);
285     bool didNotSwallowEvent = dispatchEvent(mouseEvent) && !mouseEvent->defaultHandled();
286
287     if (mouseEvent->type() == eventNames().clickEvent && mouseEvent->detail() == 2) {
288         // Special case: If it's a double click event, we also send the dblclick event. This is not part
289         // of the DOM specs, but is used for compatibility with the ondblclick="" attribute. This is treated
290         // as a separate event in other DOM-compliant browsers like Firefox, and so we do the same.
291         Ref<MouseEvent> doubleClickEvent = MouseEvent::create(eventNames().dblclickEvent,
292             mouseEvent->bubbles(), mouseEvent->cancelable(), mouseEvent->view(), mouseEvent->detail(),
293             mouseEvent->screenX(), mouseEvent->screenY(), mouseEvent->clientX(), mouseEvent->clientY(),
294             mouseEvent->ctrlKey(), mouseEvent->altKey(), mouseEvent->shiftKey(), mouseEvent->metaKey(),
295             mouseEvent->button(), mouseEvent->syntheticClickType(), relatedTarget);
296
297         if (mouseEvent->defaultHandled())
298             doubleClickEvent->setDefaultHandled();
299
300         dispatchEvent(doubleClickEvent);
301         if (doubleClickEvent->defaultHandled() || doubleClickEvent->defaultPrevented())
302             return false;
303     }
304     return didNotSwallowEvent;
305 }
306
307
308 bool Element::dispatchWheelEvent(const PlatformWheelEvent& event)
309 {
310     Ref<WheelEvent> wheelEvent = WheelEvent::create(event, document().defaultView());
311
312     // Events with no deltas are important because they convey platform information about scroll gestures
313     // and momentum beginning or ending. However, those events should not be sent to the DOM since some
314     // websites will break. They need to be dispatched because dispatching them will call into the default
315     // event handler, and our platform code will correctly handle the phase changes. Calling stopPropogation()
316     // will prevent the event from being sent to the DOM, but will still call the default event handler.
317     if (!event.deltaX() && !event.deltaY())
318         wheelEvent->stopPropagation();
319
320     return EventDispatcher::dispatchEvent(*this, wheelEvent) && !wheelEvent->defaultHandled();
321 }
322
323 bool Element::dispatchKeyEvent(const PlatformKeyboardEvent& platformEvent)
324 {
325     Ref<KeyboardEvent> event = KeyboardEvent::create(platformEvent, document().defaultView());
326     if (Frame* frame = document().frame()) {
327         if (frame->eventHandler().accessibilityPreventsEventPropogation(event))
328             event->stopPropagation();
329     }
330     return EventDispatcher::dispatchEvent(*this, event) && !event->defaultHandled();
331 }
332
333 void Element::dispatchSimulatedClick(Event* underlyingEvent, SimulatedClickMouseEventOptions eventOptions, SimulatedClickVisualOptions visualOptions)
334 {
335     simulateClick(*this, underlyingEvent, eventOptions, visualOptions, SimulatedClickSource::UserAgent);
336 }
337
338 Ref<Node> Element::cloneNodeInternal(Document& targetDocument, CloningOperation type)
339 {
340     switch (type) {
341     case CloningOperation::OnlySelf:
342     case CloningOperation::SelfWithTemplateContent:
343         return cloneElementWithoutChildren(targetDocument);
344     case CloningOperation::Everything:
345         break;
346     }
347     return cloneElementWithChildren(targetDocument);
348 }
349
350 Ref<Element> Element::cloneElementWithChildren(Document& targetDocument)
351 {
352     Ref<Element> clone = cloneElementWithoutChildren(targetDocument);
353     cloneChildNodes(clone);
354     return clone;
355 }
356
357 Ref<Element> Element::cloneElementWithoutChildren(Document& targetDocument)
358 {
359     Ref<Element> clone = cloneElementWithoutAttributesAndChildren(targetDocument);
360     // This will catch HTML elements in the wrong namespace that are not correctly copied.
361     // This is a sanity check as HTML overloads some of the DOM methods.
362     ASSERT(isHTMLElement() == clone->isHTMLElement());
363
364     clone->cloneDataFromElement(*this);
365     return clone;
366 }
367
368 Ref<Element> Element::cloneElementWithoutAttributesAndChildren(Document& targetDocument)
369 {
370     return targetDocument.createElement(tagQName(), false);
371 }
372
373 Ref<Attr> Element::detachAttribute(unsigned index)
374 {
375     ASSERT(elementData());
376
377     const Attribute& attribute = elementData()->attributeAt(index);
378
379     RefPtr<Attr> attrNode = attrIfExists(attribute.name());
380     if (attrNode)
381         detachAttrNodeFromElementWithValue(attrNode.get(), attribute.value());
382     else
383         attrNode = Attr::create(document(), attribute.name(), attribute.value());
384
385     removeAttributeInternal(index, NotInSynchronizationOfLazyAttribute);
386     return attrNode.releaseNonNull();
387 }
388
389 bool Element::removeAttribute(const QualifiedName& name)
390 {
391     if (!elementData())
392         return false;
393
394     unsigned index = elementData()->findAttributeIndexByName(name);
395     if (index == ElementData::attributeNotFound)
396         return false;
397
398     removeAttributeInternal(index, NotInSynchronizationOfLazyAttribute);
399     return true;
400 }
401
402 void Element::setBooleanAttribute(const QualifiedName& name, bool value)
403 {
404     if (value)
405         setAttribute(name, emptyAtom());
406     else
407         removeAttribute(name);
408 }
409
410 NamedNodeMap& Element::attributes() const
411 {
412     ElementRareData& rareData = const_cast<Element*>(this)->ensureElementRareData();
413     if (NamedNodeMap* attributeMap = rareData.attributeMap())
414         return *attributeMap;
415
416     rareData.setAttributeMap(std::make_unique<NamedNodeMap>(const_cast<Element&>(*this)));
417     return *rareData.attributeMap();
418 }
419
420 Node::NodeType Element::nodeType() const
421 {
422     return ELEMENT_NODE;
423 }
424
425 bool Element::hasAttribute(const QualifiedName& name) const
426 {
427     return hasAttributeNS(name.namespaceURI(), name.localName());
428 }
429
430 void Element::synchronizeAllAttributes() const
431 {
432     if (!elementData())
433         return;
434     if (elementData()->styleAttributeIsDirty()) {
435         ASSERT(isStyledElement());
436         static_cast<const StyledElement*>(this)->synchronizeStyleAttributeInternal();
437     }
438
439     if (elementData()->animatedSVGAttributesAreDirty()) {
440         ASSERT(isSVGElement());
441         downcast<SVGElement>(*this).synchronizeAnimatedSVGAttribute(anyQName());
442     }
443 }
444
445 ALWAYS_INLINE void Element::synchronizeAttribute(const QualifiedName& name) const
446 {
447     if (!elementData())
448         return;
449     if (UNLIKELY(name == styleAttr && elementData()->styleAttributeIsDirty())) {
450         ASSERT_WITH_SECURITY_IMPLICATION(isStyledElement());
451         static_cast<const StyledElement*>(this)->synchronizeStyleAttributeInternal();
452         return;
453     }
454
455     if (UNLIKELY(elementData()->animatedSVGAttributesAreDirty())) {
456         ASSERT(isSVGElement());
457         downcast<SVGElement>(*this).synchronizeAnimatedSVGAttribute(name);
458     }
459 }
460
461 static ALWAYS_INLINE bool isStyleAttribute(const Element& element, const AtomicString& attributeLocalName)
462 {
463     if (shouldIgnoreAttributeCase(element))
464         return equalLettersIgnoringASCIICase(attributeLocalName, "style");
465     return attributeLocalName == styleAttr.localName();
466 }
467
468 ALWAYS_INLINE void Element::synchronizeAttribute(const AtomicString& localName) const
469 {
470     // This version of synchronizeAttribute() is streamlined for the case where you don't have a full QualifiedName,
471     // e.g when called from DOM API.
472     if (!elementData())
473         return;
474     if (elementData()->styleAttributeIsDirty() && isStyleAttribute(*this, localName)) {
475         ASSERT_WITH_SECURITY_IMPLICATION(isStyledElement());
476         static_cast<const StyledElement*>(this)->synchronizeStyleAttributeInternal();
477         return;
478     }
479     if (elementData()->animatedSVGAttributesAreDirty()) {
480         // We're not passing a namespace argument on purpose. SVGNames::*Attr are defined w/o namespaces as well.
481         ASSERT_WITH_SECURITY_IMPLICATION(isSVGElement());
482         downcast<SVGElement>(*this).synchronizeAnimatedSVGAttribute(QualifiedName(nullAtom(), localName, nullAtom()));
483     }
484 }
485
486 const AtomicString& Element::getAttribute(const QualifiedName& name) const
487 {
488     if (!elementData())
489         return nullAtom();
490     synchronizeAttribute(name);
491     if (const Attribute* attribute = findAttributeByName(name))
492         return attribute->value();
493     return nullAtom();
494 }
495
496 Vector<String> Element::getAttributeNames() const
497 {
498     Vector<String> attributesVector;
499     if (!hasAttributes())
500         return attributesVector;
501
502     auto attributes = attributesIterator();
503     attributesVector.reserveInitialCapacity(attributes.attributeCount());
504     for (auto& attribute : attributes)
505         attributesVector.uncheckedAppend(attribute.name().toString());
506     return attributesVector;
507 }
508
509 bool Element::isFocusable() const
510 {
511     if (!isConnected() || !supportsFocus())
512         return false;
513
514     if (!renderer()) {
515         // If the node is in a display:none tree it might say it needs style recalc but
516         // the whole document is actually up to date.
517         ASSERT(!needsStyleRecalc() || !document().childNeedsStyleRecalc());
518
519         // Elements in canvas fallback content are not rendered, but they are allowed to be
520         // focusable as long as their canvas is displayed and visible.
521         if (auto* canvas = ancestorsOfType<HTMLCanvasElement>(*this).first())
522             return canvas->renderer() && canvas->renderer()->style().visibility() == VISIBLE;
523     }
524
525     // FIXME: Even if we are not visible, we might have a child that is visible.
526     // Hyatt wants to fix that some day with a "has visible content" flag or the like.
527     if (!renderer() || renderer()->style().visibility() != VISIBLE)
528         return false;
529
530     return true;
531 }
532
533 bool Element::isUserActionElementInActiveChain() const
534 {
535     ASSERT(isUserActionElement());
536     return document().userActionElements().isInActiveChain(this);
537 }
538
539 bool Element::isUserActionElementActive() const
540 {
541     ASSERT(isUserActionElement());
542     return document().userActionElements().isActive(this);
543 }
544
545 bool Element::isUserActionElementFocused() const
546 {
547     ASSERT(isUserActionElement());
548     return document().userActionElements().isFocused(this);
549 }
550
551 bool Element::isUserActionElementHovered() const
552 {
553     ASSERT(isUserActionElement());
554     return document().userActionElements().isHovered(this);
555 }
556
557 void Element::setActive(bool flag, bool pause)
558 {
559     if (flag == active())
560         return;
561
562     document().userActionElements().setActive(this, flag);
563
564     const RenderStyle* renderStyle = this->renderStyle();
565     bool reactsToPress = (renderStyle && renderStyle->affectedByActive()) || styleAffectedByActive();
566     if (reactsToPress)
567         invalidateStyleForSubtree();
568
569     if (!renderer())
570         return;
571
572     if (renderer()->style().hasAppearance() && renderer()->theme().stateChanged(*renderer(), ControlStates::PressedState))
573         reactsToPress = true;
574
575     // The rest of this function implements a feature that only works if the
576     // platform supports immediate invalidations on the ChromeClient, so bail if
577     // that isn't supported.
578     if (!document().page()->chrome().client().supportsImmediateInvalidation())
579         return;
580
581     if (reactsToPress && pause) {
582         // The delay here is subtle. It relies on an assumption, namely that the amount of time it takes
583         // to repaint the "down" state of the control is about the same time as it would take to repaint the
584         // "up" state. Once you assume this, you can just delay for 100ms - that time (assuming that after you
585         // leave this method, it will be about that long before the flush of the up state happens again).
586 #ifdef HAVE_FUNC_USLEEP
587         double startTime = monotonicallyIncreasingTime();
588 #endif
589
590         document().updateStyleIfNeeded();
591
592         // Do an immediate repaint.
593         if (renderer())
594             renderer()->repaint();
595
596         // FIXME: Come up with a less ridiculous way of doing this.
597 #ifdef HAVE_FUNC_USLEEP
598         // Now pause for a small amount of time (1/10th of a second from before we repainted in the pressed state)
599         double remainingTime = 0.1 - (monotonicallyIncreasingTime() - startTime);
600         if (remainingTime > 0)
601             usleep(static_cast<useconds_t>(remainingTime * 1000000.0));
602 #endif
603     }
604 }
605
606 void Element::setFocus(bool flag)
607 {
608     if (flag == focused())
609         return;
610
611     document().userActionElements().setFocused(this, flag);
612     invalidateStyleForSubtree();
613
614     for (Element* element = this; element; element = element->parentElementInComposedTree())
615         element->setHasFocusWithin(flag);
616 }
617
618 void Element::setHovered(bool flag)
619 {
620     if (flag == hovered())
621         return;
622
623     document().userActionElements().setHovered(this, flag);
624
625     if (!renderer()) {
626         // When setting hover to false, the style needs to be recalc'd even when
627         // there's no renderer (imagine setting display:none in the :hover class,
628         // if a nil renderer would prevent this element from recalculating its
629         // style, it would never go back to its normal style and remain
630         // stuck in its hovered style).
631         if (!flag)
632             invalidateStyleForSubtree();
633
634         return;
635     }
636
637     if (renderer()->style().affectedByHover() || childrenAffectedByHover())
638         invalidateStyleForSubtree();
639
640     if (renderer()->style().hasAppearance())
641         renderer()->theme().stateChanged(*renderer(), ControlStates::HoverState);
642 }
643
644 void Element::scrollIntoView(bool alignToTop) 
645 {
646     document().updateLayoutIgnorePendingStylesheets();
647
648     if (!renderer())
649         return;
650
651     bool insideFixed;
652     LayoutRect absoluteBounds = renderer()->absoluteAnchorRect(&insideFixed);
653     // Align to the top / bottom and to the closest edge.
654     if (alignToTop)
655         renderer()->scrollRectToVisible(SelectionRevealMode::Reveal, absoluteBounds, insideFixed, ScrollAlignment::alignToEdgeIfNeeded, ScrollAlignment::alignTopAlways);
656     else
657         renderer()->scrollRectToVisible(SelectionRevealMode::Reveal, absoluteBounds, insideFixed, ScrollAlignment::alignToEdgeIfNeeded, ScrollAlignment::alignBottomAlways);
658 }
659
660 void Element::scrollIntoViewIfNeeded(bool centerIfNeeded)
661 {
662     document().updateLayoutIgnorePendingStylesheets();
663
664     if (!renderer())
665         return;
666
667     bool insideFixed;
668     LayoutRect absoluteBounds = renderer()->absoluteAnchorRect(&insideFixed);
669     if (centerIfNeeded)
670         renderer()->scrollRectToVisible(SelectionRevealMode::Reveal, absoluteBounds, insideFixed, ScrollAlignment::alignCenterIfNeeded, ScrollAlignment::alignCenterIfNeeded);
671     else
672         renderer()->scrollRectToVisible(SelectionRevealMode::Reveal, absoluteBounds, insideFixed, ScrollAlignment::alignToEdgeIfNeeded, ScrollAlignment::alignToEdgeIfNeeded);
673 }
674
675 void Element::scrollIntoViewIfNotVisible(bool centerIfNotVisible)
676 {
677     document().updateLayoutIgnorePendingStylesheets();
678     
679     if (!renderer())
680         return;
681     
682     bool insideFixed;
683     LayoutRect absoluteBounds = renderer()->absoluteAnchorRect(&insideFixed);
684     if (centerIfNotVisible)
685         renderer()->scrollRectToVisible(SelectionRevealMode::Reveal, absoluteBounds, insideFixed, ScrollAlignment::alignCenterIfNotVisible, ScrollAlignment::alignCenterIfNotVisible);
686     else
687         renderer()->scrollRectToVisible(SelectionRevealMode::Reveal, absoluteBounds, insideFixed, ScrollAlignment::alignToEdgeIfNotVisible, ScrollAlignment::alignToEdgeIfNotVisible);
688 }
689
690 void Element::scrollBy(const ScrollToOptions& options)
691 {
692     return scrollBy(options.left.value_or(0), options.top.value_or(0));
693 }
694
695 static inline double normalizeNonFiniteValue(double f)
696 {
697     return std::isfinite(f) ? f : 0;
698 }
699
700 void Element::scrollBy(double x, double y)
701 {
702     scrollTo(scrollLeft() + normalizeNonFiniteValue(x), scrollTop() + normalizeNonFiniteValue(y));
703 }
704
705 void Element::scrollTo(const ScrollToOptions& options)
706 {
707     // If the element is the root element and document is in quirks mode, terminate these steps.
708     // Note that WebKit always uses quirks mode document scrolling behavior. See Document::scrollingElement().
709     if (this == document().documentElement())
710         return;
711
712     document().updateLayoutIgnorePendingStylesheets();
713
714     // If the element does not have any associated CSS layout box, the element has no associated scrolling box,
715     // or the element has no overflow, terminate these steps.
716     RenderBox* renderer = renderBox();
717     if (!renderer || !renderer->hasOverflowClip())
718         return;
719
720     // Normalize non-finite values for left and top dictionary members of options, if present.
721     double x = options.left ? normalizeNonFiniteValue(options.left.value()) : adjustForAbsoluteZoom(renderer->scrollLeft(), *renderer);
722     double y = options.top ? normalizeNonFiniteValue(options.top.value()) : adjustForAbsoluteZoom(renderer->scrollTop(), *renderer);
723
724     renderer->setScrollLeft(clampToInteger(x * renderer->style().effectiveZoom()));
725     renderer->setScrollTop(clampToInteger(y * renderer->style().effectiveZoom()));
726 }
727
728 void Element::scrollTo(double x, double y)
729 {
730     scrollTo({ x, y });
731 }
732
733 void Element::scrollByUnits(int units, ScrollGranularity granularity)
734 {
735     document().updateLayoutIgnorePendingStylesheets();
736
737     auto* renderer = this->renderer();
738     if (!renderer)
739         return;
740
741     if (!renderer->hasOverflowClip())
742         return;
743
744     ScrollDirection direction = ScrollDown;
745     if (units < 0) {
746         direction = ScrollUp;
747         units = -units;
748     }
749     Element* stopElement = this;
750     downcast<RenderBox>(*renderer).scroll(direction, granularity, units, &stopElement);
751 }
752
753 void Element::scrollByLines(int lines)
754 {
755     scrollByUnits(lines, ScrollByLine);
756 }
757
758 void Element::scrollByPages(int pages)
759 {
760     scrollByUnits(pages, ScrollByPage);
761 }
762
763 static double localZoomForRenderer(const RenderElement& renderer)
764 {
765     // FIXME: This does the wrong thing if two opposing zooms are in effect and canceled each
766     // other out, but the alternative is that we'd have to crawl up the whole render tree every
767     // time (or store an additional bit in the RenderStyle to indicate that a zoom was specified).
768     double zoomFactor = 1;
769     if (renderer.style().effectiveZoom() != 1) {
770         // Need to find the nearest enclosing RenderElement that set up
771         // a differing zoom, and then we divide our result by it to eliminate the zoom.
772         const RenderElement* prev = &renderer;
773         for (RenderElement* curr = prev->parent(); curr; curr = curr->parent()) {
774             if (curr->style().effectiveZoom() != prev->style().effectiveZoom()) {
775                 zoomFactor = prev->style().zoom();
776                 break;
777             }
778             prev = curr;
779         }
780         if (prev->isRenderView())
781             zoomFactor = prev->style().zoom();
782     }
783     return zoomFactor;
784 }
785
786 static double adjustForLocalZoom(LayoutUnit value, const RenderElement& renderer, double& zoomFactor)
787 {
788     zoomFactor = localZoomForRenderer(renderer);
789     if (zoomFactor == 1)
790         return value.toDouble();
791     return value.toDouble() / zoomFactor;
792 }
793
794 enum LegacyCSSOMElementMetricsRoundingStrategy { Round, Floor };
795
796 static bool subpixelMetricsEnabled(const Document& document)
797 {
798     return document.settings().subpixelCSSOMElementMetricsEnabled();
799 }
800
801 static double convertToNonSubpixelValueIfNeeded(double value, const Document& document, LegacyCSSOMElementMetricsRoundingStrategy roundStrategy = Round)
802 {
803     return subpixelMetricsEnabled(document) ? value : roundStrategy == Round ? round(value) : floor(value);
804 }
805
806 double Element::offsetLeft()
807 {
808     document().updateLayoutIgnorePendingStylesheets();
809     if (RenderBoxModelObject* renderer = renderBoxModelObject()) {
810         LayoutUnit offsetLeft = subpixelMetricsEnabled(renderer->document()) ? renderer->offsetLeft() : LayoutUnit(roundToInt(renderer->offsetLeft()));
811         double zoomFactor = 1;
812         double offsetLeftAdjustedWithZoom = adjustForLocalZoom(offsetLeft, *renderer, zoomFactor);
813         return convertToNonSubpixelValueIfNeeded(offsetLeftAdjustedWithZoom, renderer->document(), zoomFactor == 1 ? Floor : Round);
814     }
815     return 0;
816 }
817
818 double Element::offsetTop()
819 {
820     document().updateLayoutIgnorePendingStylesheets();
821     if (RenderBoxModelObject* renderer = renderBoxModelObject()) {
822         LayoutUnit offsetTop = subpixelMetricsEnabled(renderer->document()) ? renderer->offsetTop() : LayoutUnit(roundToInt(renderer->offsetTop()));
823         double zoomFactor = 1;
824         double offsetTopAdjustedWithZoom = adjustForLocalZoom(offsetTop, *renderer, zoomFactor);
825         return convertToNonSubpixelValueIfNeeded(offsetTopAdjustedWithZoom, renderer->document(), zoomFactor == 1 ? Floor : Round);
826     }
827     return 0;
828 }
829
830 double Element::offsetWidth()
831 {
832     document().updateLayoutIfDimensionsOutOfDate(*this, WidthDimensionsCheck);
833     if (RenderBoxModelObject* renderer = renderBoxModelObject()) {
834         LayoutUnit offsetWidth = subpixelMetricsEnabled(renderer->document()) ? renderer->offsetWidth() : LayoutUnit(roundToInt(renderer->offsetWidth()));
835         return convertToNonSubpixelValueIfNeeded(adjustLayoutUnitForAbsoluteZoom(offsetWidth, *renderer).toDouble(), renderer->document());
836     }
837     return 0;
838 }
839
840 double Element::offsetHeight()
841 {
842     document().updateLayoutIfDimensionsOutOfDate(*this, HeightDimensionsCheck);
843     if (RenderBoxModelObject* renderer = renderBoxModelObject()) {
844         LayoutUnit offsetHeight = subpixelMetricsEnabled(renderer->document()) ? renderer->offsetHeight() : LayoutUnit(roundToInt(renderer->offsetHeight()));
845         return convertToNonSubpixelValueIfNeeded(adjustLayoutUnitForAbsoluteZoom(offsetHeight, *renderer).toDouble(), renderer->document());
846     }
847     return 0;
848 }
849
850 Element* Element::bindingsOffsetParent()
851 {
852     Element* element = offsetParent();
853     if (!element || !element->isInShadowTree())
854         return element;
855     return element->containingShadowRoot()->mode() == ShadowRootMode::UserAgent ? nullptr : element;
856 }
857
858 Element* Element::offsetParent()
859 {
860     document().updateLayoutIgnorePendingStylesheets();
861     auto renderer = this->renderer();
862     if (!renderer)
863         return nullptr;
864     auto offsetParent = renderer->offsetParent();
865     if (!offsetParent)
866         return nullptr;
867     return offsetParent->element();
868 }
869
870 double Element::clientLeft()
871 {
872     document().updateLayoutIgnorePendingStylesheets();
873
874     if (auto* renderer = renderBox()) {
875         LayoutUnit clientLeft = subpixelMetricsEnabled(renderer->document()) ? renderer->clientLeft() : LayoutUnit(roundToInt(renderer->clientLeft()));
876         return convertToNonSubpixelValueIfNeeded(adjustLayoutUnitForAbsoluteZoom(clientLeft, *renderer).toDouble(), renderer->document());
877     }
878     return 0;
879 }
880
881 double Element::clientTop()
882 {
883     document().updateLayoutIgnorePendingStylesheets();
884
885     if (auto* renderer = renderBox()) {
886         LayoutUnit clientTop = subpixelMetricsEnabled(renderer->document()) ? renderer->clientTop() : LayoutUnit(roundToInt(renderer->clientTop()));
887         return convertToNonSubpixelValueIfNeeded(adjustLayoutUnitForAbsoluteZoom(clientTop, *renderer).toDouble(), renderer->document());
888     }
889     return 0;
890 }
891
892 double Element::clientWidth()
893 {
894     document().updateLayoutIfDimensionsOutOfDate(*this, WidthDimensionsCheck);
895
896     if (!document().hasLivingRenderTree())
897         return 0;
898
899     RenderView& renderView = *document().renderView();
900
901     // When in strict mode, clientWidth for the document element should return the width of the containing frame.
902     // When in quirks mode, clientWidth for the body element should return the width of the containing frame.
903     bool inQuirksMode = document().inQuirksMode();
904     if ((!inQuirksMode && document().documentElement() == this) || (inQuirksMode && isHTMLElement() && document().bodyOrFrameset() == this))
905         return adjustForAbsoluteZoom(renderView.frameView().layoutWidth(), renderView);
906     
907     if (RenderBox* renderer = renderBox()) {
908         LayoutUnit clientWidth = subpixelMetricsEnabled(renderer->document()) ? renderer->clientWidth() : LayoutUnit(roundToInt(renderer->clientWidth()));
909         return convertToNonSubpixelValueIfNeeded(adjustLayoutUnitForAbsoluteZoom(clientWidth, *renderer).toDouble(), renderer->document());
910     }
911     return 0;
912 }
913
914 double Element::clientHeight()
915 {
916     document().updateLayoutIfDimensionsOutOfDate(*this, HeightDimensionsCheck);
917     if (!document().hasLivingRenderTree())
918         return 0;
919
920     RenderView& renderView = *document().renderView();
921
922     // When in strict mode, clientHeight for the document element should return the height of the containing frame.
923     // When in quirks mode, clientHeight for the body element should return the height of the containing frame.
924     bool inQuirksMode = document().inQuirksMode();
925     if ((!inQuirksMode && document().documentElement() == this) || (inQuirksMode && isHTMLElement() && document().bodyOrFrameset() == this))
926         return adjustForAbsoluteZoom(renderView.frameView().layoutHeight(), renderView);
927
928     if (RenderBox* renderer = renderBox()) {
929         LayoutUnit clientHeight = subpixelMetricsEnabled(renderer->document()) ? renderer->clientHeight() : LayoutUnit(roundToInt(renderer->clientHeight()));
930         return convertToNonSubpixelValueIfNeeded(adjustLayoutUnitForAbsoluteZoom(clientHeight, *renderer).toDouble(), renderer->document());
931     }
932     return 0;
933 }
934
935 int Element::scrollLeft()
936 {
937     document().updateLayoutIgnorePendingStylesheets();
938
939     if (auto* renderer = renderBox())
940         return adjustForAbsoluteZoom(renderer->scrollLeft(), *renderer);
941     return 0;
942 }
943
944 int Element::scrollTop()
945 {
946     document().updateLayoutIgnorePendingStylesheets();
947
948     if (RenderBox* renderer = renderBox())
949         return adjustForAbsoluteZoom(renderer->scrollTop(), *renderer);
950     return 0;
951 }
952
953 void Element::setScrollLeft(int newLeft)
954 {
955     document().updateLayoutIgnorePendingStylesheets();
956
957     if (auto* renderer = renderBox()) {
958         renderer->setScrollLeft(static_cast<int>(newLeft * renderer->style().effectiveZoom()));
959         if (auto* scrollableArea = renderer->layer())
960             scrollableArea->setScrolledProgrammatically(true);
961     }
962 }
963
964 void Element::setScrollTop(int newTop)
965 {
966     document().updateLayoutIgnorePendingStylesheets();
967
968     if (auto* renderer = renderBox()) {
969         renderer->setScrollTop(static_cast<int>(newTop * renderer->style().effectiveZoom()));
970         if (auto* scrollableArea = renderer->layer())
971             scrollableArea->setScrolledProgrammatically(true);
972     }
973 }
974
975 int Element::scrollWidth()
976 {
977     document().updateLayoutIfDimensionsOutOfDate(*this, WidthDimensionsCheck);
978     if (auto* renderer = renderBox())
979         return adjustForAbsoluteZoom(renderer->scrollWidth(), *renderer);
980     return 0;
981 }
982
983 int Element::scrollHeight()
984 {
985     document().updateLayoutIfDimensionsOutOfDate(*this, HeightDimensionsCheck);
986     if (auto* renderer = renderBox())
987         return adjustForAbsoluteZoom(renderer->scrollHeight(), *renderer);
988     return 0;
989 }
990
991 IntRect Element::boundsInRootViewSpace()
992 {
993     document().updateLayoutIgnorePendingStylesheets();
994
995     FrameView* view = document().view();
996     if (!view)
997         return IntRect();
998
999     Vector<FloatQuad> quads;
1000
1001     if (isSVGElement() && renderer()) {
1002         // Get the bounding rectangle from the SVG model.
1003         SVGElement& svgElement = downcast<SVGElement>(*this);
1004         FloatRect localRect;
1005         if (svgElement.getBoundingBox(localRect))
1006             quads.append(renderer()->localToAbsoluteQuad(localRect));
1007     } else {
1008         // Get the bounding rectangle from the box model.
1009         if (renderBoxModelObject())
1010             renderBoxModelObject()->absoluteQuads(quads);
1011     }
1012
1013     if (quads.isEmpty())
1014         return IntRect();
1015
1016     IntRect result = quads[0].enclosingBoundingBox();
1017     for (size_t i = 1; i < quads.size(); ++i)
1018         result.unite(quads[i].enclosingBoundingBox());
1019
1020     result = view->contentsToRootView(result);
1021     return result;
1022 }
1023
1024 static bool layoutOverflowRectContainsAllDescendants(const RenderBox& renderBox)
1025 {
1026     if (renderBox.isRenderView())
1027         return true;
1028
1029     if (!renderBox.element())
1030         return false;
1031
1032     // If there are any position:fixed inside of us, game over.
1033     if (auto* viewPositionedObjects = renderBox.view().positionedObjects()) {
1034         for (auto* positionedBox : *viewPositionedObjects) {
1035             if (positionedBox == &renderBox)
1036                 continue;
1037             if (positionedBox->style().position() == FixedPosition && renderBox.element()->contains(positionedBox->element()))
1038                 return false;
1039         }
1040     }
1041
1042     if (renderBox.canContainAbsolutelyPositionedObjects()) {
1043         // Our layout overflow will include all descendant positioned elements.
1044         return true;
1045     }
1046
1047     // This renderer may have positioned descendants whose containing block is some ancestor.
1048     if (auto* containingBlock = renderBox.containingBlockForAbsolutePosition()) {
1049         if (auto* positionedObjects = containingBlock->positionedObjects()) {
1050             for (auto* positionedBox : *positionedObjects) {
1051                 if (positionedBox == &renderBox)
1052                     continue;
1053                 if (renderBox.element()->contains(positionedBox->element()))
1054                     return false;
1055             }
1056         }
1057     }
1058     return false;
1059 }
1060
1061 LayoutRect Element::absoluteEventBounds(bool& boundsIncludeAllDescendantElements, bool& includesFixedPositionElements)
1062 {
1063     boundsIncludeAllDescendantElements = false;
1064     includesFixedPositionElements = false;
1065
1066     if (!renderer())
1067         return LayoutRect();
1068
1069     LayoutRect result;
1070     if (isSVGElement()) {
1071         // Get the bounding rectangle from the SVG model.
1072         SVGElement& svgElement = downcast<SVGElement>(*this);
1073         FloatRect localRect;
1074         if (svgElement.getBoundingBox(localRect, SVGLocatable::DisallowStyleUpdate))
1075             result = LayoutRect(renderer()->localToAbsoluteQuad(localRect, UseTransforms, &includesFixedPositionElements).boundingBox());
1076     } else {
1077         auto* renderer = this->renderer();
1078         if (is<RenderBox>(renderer)) {
1079             auto& box = downcast<RenderBox>(*renderer);
1080
1081             bool computedBounds = false;
1082             
1083             if (RenderFlowThread* flowThread = box.flowThreadContainingBlock()) {
1084                 bool wasFixed = false;
1085                 Vector<FloatQuad> quads;
1086                 FloatRect localRect(0, 0, box.width(), box.height());
1087                 if (flowThread->absoluteQuadsForBox(quads, &wasFixed, &box, localRect.y(), localRect.maxY())) {
1088                     FloatRect quadBounds = quads[0].boundingBox();
1089                     for (size_t i = 1; i < quads.size(); ++i)
1090                         quadBounds.unite(quads[i].boundingBox());
1091                     
1092                     result = LayoutRect(quadBounds);
1093                     computedBounds = true;
1094                 } else {
1095                     // Probably columns. Just return the bounds of the multicol block for now.
1096                     // FIXME: this doesn't handle nested columns.
1097                     RenderElement* multicolContainer = flowThread->parent();
1098                     if (multicolContainer && is<RenderBox>(multicolContainer)) {
1099                         auto overflowRect = downcast<RenderBox>(*multicolContainer).layoutOverflowRect();
1100                         result = LayoutRect(multicolContainer->localToAbsoluteQuad(FloatRect(overflowRect), UseTransforms, &includesFixedPositionElements).boundingBox());
1101                         computedBounds = true;
1102                     }
1103                 }
1104             }
1105
1106             if (!computedBounds) {
1107                 LayoutRect overflowRect = box.layoutOverflowRect();
1108                 result = LayoutRect(box.localToAbsoluteQuad(FloatRect(overflowRect), UseTransforms, &includesFixedPositionElements).boundingBox());
1109                 boundsIncludeAllDescendantElements = layoutOverflowRectContainsAllDescendants(box);
1110             }
1111         } else
1112             result = LayoutRect(renderer->absoluteBoundingBoxRect(true /* useTransforms */, &includesFixedPositionElements));
1113     }
1114
1115     return result;
1116 }
1117
1118 LayoutRect Element::absoluteEventBoundsOfElementAndDescendants(bool& includesFixedPositionElements)
1119 {
1120     bool boundsIncludeDescendants;
1121     LayoutRect result = absoluteEventBounds(boundsIncludeDescendants, includesFixedPositionElements);
1122     if (boundsIncludeDescendants)
1123         return result;
1124
1125     for (auto& child : childrenOfType<Element>(*this)) {
1126         bool includesFixedPosition = false;
1127         LayoutRect childBounds = child.absoluteEventBoundsOfElementAndDescendants(includesFixedPosition);
1128         includesFixedPositionElements |= includesFixedPosition;
1129         result.unite(childBounds);
1130     }
1131
1132     return result;
1133 }
1134
1135 LayoutRect Element::absoluteEventHandlerBounds(bool& includesFixedPositionElements)
1136 {
1137     // This is not web-exposed, so don't call the FOUC-inducing updateLayoutIgnorePendingStylesheets().
1138     FrameView* frameView = document().view();
1139     if (!frameView)
1140         return LayoutRect();
1141
1142     if (frameView->needsLayout())
1143         frameView->layout();
1144
1145     return absoluteEventBoundsOfElementAndDescendants(includesFixedPositionElements);
1146 }
1147
1148 Ref<DOMRectList> Element::getClientRects()
1149 {
1150     document().updateLayoutIgnorePendingStylesheets();
1151
1152     RenderBoxModelObject* renderBoxModelObject = this->renderBoxModelObject();
1153     if (!renderBoxModelObject)
1154         return DOMRectList::create();
1155
1156     // FIXME: Handle SVG elements.
1157     // FIXME: Handle table/inline-table with a caption.
1158
1159     Vector<FloatQuad> quads;
1160     renderBoxModelObject->absoluteQuads(quads);
1161     document().convertAbsoluteToClientQuads(quads, renderBoxModelObject->style());
1162     return DOMRectList::create(quads);
1163 }
1164
1165 FloatRect Element::boundingClientRect()
1166 {
1167     document().updateLayoutIgnorePendingStylesheets();
1168
1169     Vector<FloatQuad> quads;
1170     if (isSVGElement() && renderer() && !renderer()->isSVGRoot()) {
1171         // Get the bounding rectangle from the SVG model.
1172         SVGElement& svgElement = downcast<SVGElement>(*this);
1173         FloatRect localRect;
1174         if (svgElement.getBoundingBox(localRect))
1175             quads.append(renderer()->localToAbsoluteQuad(localRect));
1176     } else {
1177         // Get the bounding rectangle from the box model.
1178         if (renderBoxModelObject())
1179             renderBoxModelObject()->absoluteQuads(quads);
1180     }
1181
1182     if (quads.isEmpty())
1183         return { };
1184
1185     FloatRect result = quads[0].boundingBox();
1186     for (size_t i = 1; i < quads.size(); ++i)
1187         result.unite(quads[i].boundingBox());
1188
1189     document().convertAbsoluteToClientRect(result, renderer()->style());
1190     return result;
1191 }
1192
1193 Ref<DOMRect> Element::getBoundingClientRect()
1194 {
1195     return DOMRect::create(boundingClientRect());
1196 }
1197
1198 // Note that this is not web-exposed, and does not use the same coordinate system as getBoundingClientRect() and friends.
1199 IntRect Element::clientRect() const
1200 {
1201     if (RenderObject* renderer = this->renderer())
1202         return document().view()->contentsToRootView(renderer->absoluteBoundingBoxRect());
1203     return IntRect();
1204 }
1205     
1206 IntRect Element::screenRect() const
1207 {
1208     if (RenderObject* renderer = this->renderer())
1209         return document().view()->contentsToScreen(renderer->absoluteBoundingBoxRect());
1210     return IntRect();
1211 }
1212
1213 const AtomicString& Element::getAttribute(const AtomicString& localName) const
1214 {
1215     if (!elementData())
1216         return nullAtom();
1217     synchronizeAttribute(localName);
1218     if (const Attribute* attribute = elementData()->findAttributeByName(localName, shouldIgnoreAttributeCase(*this)))
1219         return attribute->value();
1220     return nullAtom();
1221 }
1222
1223 const AtomicString& Element::getAttributeNS(const AtomicString& namespaceURI, const AtomicString& localName) const
1224 {
1225     return getAttribute(QualifiedName(nullAtom(), localName, namespaceURI));
1226 }
1227
1228 ExceptionOr<void> Element::setAttribute(const AtomicString& localName, const AtomicString& value)
1229 {
1230     if (!Document::isValidName(localName))
1231         return Exception { INVALID_CHARACTER_ERR };
1232
1233     synchronizeAttribute(localName);
1234     auto caseAdjustedLocalName = shouldIgnoreAttributeCase(*this) ? localName.convertToASCIILowercase() : localName;
1235     unsigned index = elementData() ? elementData()->findAttributeIndexByName(caseAdjustedLocalName, false) : ElementData::attributeNotFound;
1236     auto name = index != ElementData::attributeNotFound ? attributeAt(index).name() : QualifiedName { nullAtom(), caseAdjustedLocalName, nullAtom() };
1237     setAttributeInternal(index, name, value, NotInSynchronizationOfLazyAttribute);
1238
1239     return { };
1240 }
1241
1242 void Element::setAttribute(const QualifiedName& name, const AtomicString& value)
1243 {
1244     synchronizeAttribute(name);
1245     unsigned index = elementData() ? elementData()->findAttributeIndexByName(name) : ElementData::attributeNotFound;
1246     setAttributeInternal(index, name, value, NotInSynchronizationOfLazyAttribute);
1247 }
1248
1249 void Element::setAttributeWithoutSynchronization(const QualifiedName& name, const AtomicString& value)
1250 {
1251     unsigned index = elementData() ? elementData()->findAttributeIndexByName(name) : ElementData::attributeNotFound;
1252     setAttributeInternal(index, name, value, NotInSynchronizationOfLazyAttribute);
1253 }
1254
1255 void Element::setSynchronizedLazyAttribute(const QualifiedName& name, const AtomicString& value)
1256 {
1257     unsigned index = elementData() ? elementData()->findAttributeIndexByName(name) : ElementData::attributeNotFound;
1258     setAttributeInternal(index, name, value, InSynchronizationOfLazyAttribute);
1259 }
1260
1261 inline void Element::setAttributeInternal(unsigned index, const QualifiedName& name, const AtomicString& newValue, SynchronizationOfLazyAttribute inSynchronizationOfLazyAttribute)
1262 {
1263     if (newValue.isNull()) {
1264         if (index != ElementData::attributeNotFound)
1265             removeAttributeInternal(index, inSynchronizationOfLazyAttribute);
1266         return;
1267     }
1268
1269     if (index == ElementData::attributeNotFound) {
1270         addAttributeInternal(name, newValue, inSynchronizationOfLazyAttribute);
1271         return;
1272     }
1273
1274     if (inSynchronizationOfLazyAttribute) {
1275         ensureUniqueElementData().attributeAt(index).setValue(newValue);
1276         return;
1277     }
1278
1279     const Attribute& attribute = attributeAt(index);
1280     QualifiedName attributeName = attribute.name();
1281     AtomicString oldValue = attribute.value();
1282
1283     willModifyAttribute(attributeName, oldValue, newValue);
1284
1285     if (newValue != oldValue) {
1286         Style::AttributeChangeInvalidation styleInvalidation(*this, name, oldValue, newValue);
1287         ensureUniqueElementData().attributeAt(index).setValue(newValue);
1288     }
1289
1290     didModifyAttribute(attributeName, oldValue, newValue);
1291 }
1292
1293 static inline AtomicString makeIdForStyleResolution(const AtomicString& value, bool inQuirksMode)
1294 {
1295     if (inQuirksMode)
1296         return value.convertToASCIILowercase();
1297     return value;
1298 }
1299
1300 void Element::attributeChanged(const QualifiedName& name, const AtomicString& oldValue, const AtomicString& newValue, AttributeModificationReason)
1301 {
1302     bool valueIsSameAsBefore = oldValue == newValue;
1303
1304     if (!valueIsSameAsBefore) {
1305         if (name == HTMLNames::idAttr) {
1306             if (!oldValue.isEmpty())
1307                 treeScope().idTargetObserverRegistry().notifyObservers(*oldValue.impl());
1308             if (!newValue.isEmpty())
1309                 treeScope().idTargetObserverRegistry().notifyObservers(*newValue.impl());
1310
1311             AtomicString oldId = elementData()->idForStyleResolution();
1312             AtomicString newId = makeIdForStyleResolution(newValue, document().inQuirksMode());
1313             if (newId != oldId) {
1314                 Style::IdChangeInvalidation styleInvalidation(*this, oldId, newId);
1315                 elementData()->setIdForStyleResolution(newId);
1316             }
1317         } else if (name == classAttr)
1318             classAttributeChanged(newValue);
1319         else if (name == HTMLNames::nameAttr)
1320             elementData()->setHasNameAttribute(!newValue.isNull());
1321         else if (name == HTMLNames::pseudoAttr) {
1322             if (needsStyleInvalidation() && isInShadowTree())
1323                 invalidateStyleForSubtree();
1324         }
1325         else if (name == HTMLNames::slotAttr) {
1326             if (auto* parent = parentElement()) {
1327                 if (auto* shadowRoot = parent->shadowRoot())
1328                     shadowRoot->hostChildElementDidChangeSlotAttribute(*this, oldValue, newValue);
1329             }
1330         }
1331     }
1332
1333     parseAttribute(name, newValue);
1334
1335     document().incDOMTreeVersion();
1336
1337     if (UNLIKELY(isDefinedCustomElement()))
1338         CustomElementReactionQueue::enqueueAttributeChangedCallbackIfNeeded(*this, name, oldValue, newValue);
1339
1340     if (valueIsSameAsBefore)
1341         return;
1342
1343     invalidateNodeListAndCollectionCachesInAncestorsForAttribute(name);
1344
1345     if (AXObjectCache* cache = document().existingAXObjectCache())
1346         cache->handleAttributeChanged(name, this);
1347 }
1348
1349 template <typename CharacterType>
1350 static inline bool classStringHasClassName(const CharacterType* characters, unsigned length)
1351 {
1352     ASSERT(length > 0);
1353
1354     unsigned i = 0;
1355     do {
1356         if (isNotHTMLSpace(characters[i]))
1357             break;
1358         ++i;
1359     } while (i < length);
1360
1361     return i < length;
1362 }
1363
1364 static inline bool classStringHasClassName(const AtomicString& newClassString)
1365 {
1366     unsigned length = newClassString.length();
1367
1368     if (!length)
1369         return false;
1370
1371     if (newClassString.is8Bit())
1372         return classStringHasClassName(newClassString.characters8(), length);
1373     return classStringHasClassName(newClassString.characters16(), length);
1374 }
1375
1376 void Element::classAttributeChanged(const AtomicString& newClassString)
1377 {
1378     // Note: We'll need ElementData, but it doesn't have to be UniqueElementData.
1379     if (!elementData())
1380         ensureUniqueElementData();
1381
1382     bool shouldFoldCase = document().inQuirksMode();
1383     bool newStringHasClasses = classStringHasClassName(newClassString);
1384
1385     auto oldClassNames = elementData()->classNames();
1386     auto newClassNames = newStringHasClasses ? SpaceSplitString(newClassString, shouldFoldCase) : SpaceSplitString();
1387     {
1388         Style::ClassChangeInvalidation styleInvalidation(*this, oldClassNames, newClassNames);
1389         elementData()->setClassNames(newClassNames);
1390     }
1391
1392     if (hasRareData()) {
1393         if (auto* classList = elementRareData()->classList())
1394             classList->associatedAttributeValueChanged(newClassString);
1395     }
1396 }
1397
1398 URL Element::absoluteLinkURL() const
1399 {
1400     if (!isLink())
1401         return URL();
1402
1403     AtomicString linkAttribute;
1404     if (hasTagName(SVGNames::aTag))
1405         linkAttribute = getAttribute(XLinkNames::hrefAttr);
1406     else
1407         linkAttribute = getAttribute(HTMLNames::hrefAttr);
1408
1409     if (linkAttribute.isEmpty())
1410         return URL();
1411
1412     return document().completeURL(stripLeadingAndTrailingHTMLSpaces(linkAttribute));
1413 }
1414
1415 #if ENABLE(TOUCH_EVENTS)
1416 bool Element::allowsDoubleTapGesture() const
1417 {
1418     if (renderStyle() && renderStyle()->touchAction() != TouchAction::Auto)
1419         return false;
1420
1421     Element* parent = parentElement();
1422     return !parent || parent->allowsDoubleTapGesture();
1423 }
1424 #endif
1425
1426 StyleResolver& Element::styleResolver()
1427 {
1428     if (auto* shadowRoot = containingShadowRoot())
1429         return shadowRoot->styleScope().resolver();
1430
1431     return document().styleScope().resolver();
1432 }
1433
1434 ElementStyle Element::resolveStyle(const RenderStyle* parentStyle)
1435 {
1436     return styleResolver().styleForElement(*this, parentStyle);
1437 }
1438
1439 void Element::invalidateStyle()
1440 {
1441     Node::invalidateStyle(Style::Validity::ElementInvalid);
1442 }
1443
1444 void Element::invalidateStyleAndLayerComposition()
1445 {
1446     Node::invalidateStyle(Style::Validity::ElementInvalid, Style::InvalidationMode::RecompositeLayer);
1447 }
1448
1449 void Element::invalidateStyleForSubtree()
1450 {
1451     Node::invalidateStyle(Style::Validity::SubtreeInvalid);
1452 }
1453
1454 void Element::invalidateStyleAndRenderersForSubtree()
1455 {
1456     Node::invalidateStyle(Style::Validity::SubtreeAndRenderersInvalid);
1457 }
1458
1459 #if ENABLE(WEB_ANIMATIONS)
1460 WebAnimationVector Element::getAnimations()
1461 {
1462     auto checkTarget = [this](AnimationEffect const& effect)
1463     {
1464         return (static_cast<KeyframeEffect const&>(effect).target() == this);
1465     };
1466
1467     auto* document = DocumentAnimation::from(&this->document());
1468     if (document)
1469         return document->getAnimations(WTFMove(checkTarget));
1470     return WebAnimationVector();
1471 }
1472 #endif
1473
1474 bool Element::hasDisplayContents() const
1475 {
1476     if (renderer() || !hasRareData())
1477         return false;
1478     const RenderStyle* style = elementRareData()->computedStyle();
1479     return style && style->display() == CONTENTS;
1480 }
1481
1482 void Element::storeDisplayContentsStyle(std::unique_ptr<RenderStyle> style)
1483 {
1484     ASSERT(style && style->display() == CONTENTS);
1485     ASSERT(!renderer());
1486     ensureElementRareData().setComputedStyle(WTFMove(style));
1487 }
1488
1489 // Returns true is the given attribute is an event handler.
1490 // We consider an event handler any attribute that begins with "on".
1491 // It is a simple solution that has the advantage of not requiring any
1492 // code or configuration change if a new event handler is defined.
1493
1494 static inline bool isEventHandlerAttribute(const Attribute& attribute)
1495 {
1496     return attribute.name().namespaceURI().isNull() && attribute.name().localName().startsWith("on");
1497 }
1498
1499 bool Element::isJavaScriptURLAttribute(const Attribute& attribute) const
1500 {
1501     return isURLAttribute(attribute) && protocolIsJavaScript(stripLeadingAndTrailingHTMLSpaces(attribute.value()));
1502 }
1503
1504 void Element::stripScriptingAttributes(Vector<Attribute>& attributeVector) const
1505 {
1506     attributeVector.removeAllMatching([this](auto& attribute) -> bool {
1507         return isEventHandlerAttribute(attribute)
1508             || this->isJavaScriptURLAttribute(attribute)
1509             || this->isHTMLContentAttribute(attribute);
1510     });
1511 }
1512
1513 void Element::parserSetAttributes(const Vector<Attribute>& attributeVector)
1514 {
1515     ASSERT(!isConnected());
1516     ASSERT(!parentNode());
1517     ASSERT(!m_elementData);
1518
1519     if (!attributeVector.isEmpty()) {
1520         if (document().sharedObjectPool())
1521             m_elementData = document().sharedObjectPool()->cachedShareableElementDataWithAttributes(attributeVector);
1522         else
1523             m_elementData = ShareableElementData::createWithAttributes(attributeVector);
1524
1525     }
1526
1527     parserDidSetAttributes();
1528
1529     // Use attributeVector instead of m_elementData because attributeChanged might modify m_elementData.
1530     for (const auto& attribute : attributeVector)
1531         attributeChanged(attribute.name(), nullAtom(), attribute.value(), ModifiedDirectly);
1532 }
1533
1534 void Element::parserDidSetAttributes()
1535 {
1536 }
1537
1538 void Element::didMoveToNewDocument(Document& oldDocument, Document& newDocument)
1539 {
1540     ASSERT_WITH_SECURITY_IMPLICATION(&document() == &newDocument);
1541     Node::didMoveToNewDocument(oldDocument, newDocument);
1542
1543     if (oldDocument.inQuirksMode() != document().inQuirksMode()) {
1544         // ElementData::m_classNames or ElementData::m_idForStyleResolution need to be updated with the right case.
1545         if (hasID())
1546             attributeChanged(idAttr, nullAtom(), getIdAttribute());
1547         if (hasClass())
1548             attributeChanged(classAttr, nullAtom(), getAttribute(classAttr));
1549     }
1550
1551     if (UNLIKELY(isDefinedCustomElement()))
1552         CustomElementReactionQueue::enqueueAdoptedCallbackIfNeeded(*this, oldDocument, newDocument);
1553 }
1554
1555 bool Element::hasAttributes() const
1556 {
1557     synchronizeAllAttributes();
1558     return elementData() && elementData()->length();
1559 }
1560
1561 bool Element::hasEquivalentAttributes(const Element* other) const
1562 {
1563     synchronizeAllAttributes();
1564     other->synchronizeAllAttributes();
1565     if (elementData() == other->elementData())
1566         return true;
1567     if (elementData())
1568         return elementData()->isEquivalent(other->elementData());
1569     if (other->elementData())
1570         return other->elementData()->isEquivalent(elementData());
1571     return true;
1572 }
1573
1574 String Element::nodeName() const
1575 {
1576     return m_tagName.toString();
1577 }
1578
1579 String Element::nodeNamePreservingCase() const
1580 {
1581     return m_tagName.toString();
1582 }
1583
1584 ExceptionOr<void> Element::setPrefix(const AtomicString& prefix)
1585 {
1586     auto result = checkSetPrefix(prefix);
1587     if (result.hasException())
1588         return result.releaseException();
1589
1590     m_tagName.setPrefix(prefix.isEmpty() ? nullAtom() : prefix);
1591     return { };
1592 }
1593
1594 const AtomicString& Element::imageSourceURL() const
1595 {
1596     return attributeWithoutSynchronization(srcAttr);
1597 }
1598
1599 bool Element::rendererIsNeeded(const RenderStyle& style)
1600 {
1601     return style.display() != NONE && style.display() != CONTENTS;
1602 }
1603
1604 RenderPtr<RenderElement> Element::createElementRenderer(RenderStyle&& style, const RenderTreePosition&)
1605 {
1606     return RenderElement::createFor(*this, WTFMove(style));
1607 }
1608
1609 Node::InsertionNotificationRequest Element::insertedInto(ContainerNode& insertionPoint)
1610 {
1611     bool wasInDocument = isConnected();
1612     // need to do superclass processing first so isConnected() is true
1613     // by the time we reach updateId
1614     ContainerNode::insertedInto(insertionPoint);
1615     ASSERT(!wasInDocument || isConnected());
1616
1617 #if ENABLE(FULLSCREEN_API)
1618     if (containsFullScreenElement() && parentElement() && !parentElement()->containsFullScreenElement())
1619         setContainsFullScreenElementOnAncestorsCrossingFrameBoundaries(true);
1620 #endif
1621
1622     if (parentNode() == &insertionPoint) {
1623         if (auto* shadowRoot = parentNode()->shadowRoot())
1624             shadowRoot->hostChildElementDidChange(*this);
1625     }
1626
1627     if (!insertionPoint.isInTreeScope())
1628         return InsertionDone;
1629
1630     // This function could be called when this element's shadow root's host or its ancestor is inserted.
1631     // This element is new to the shadow tree (and its tree scope) only if the parent into which this element
1632     // or its ancestor is inserted belongs to the same tree scope as this element's.
1633     TreeScope* newScope = &insertionPoint.treeScope();
1634     bool becomeConnected = !wasInDocument && isConnected();
1635     HTMLDocument* newDocument = becomeConnected && is<HTMLDocument>(newScope->documentScope()) ? &downcast<HTMLDocument>(newScope->documentScope()) : nullptr;
1636     if (newScope != &treeScope())
1637         newScope = nullptr;
1638
1639     const AtomicString& idValue = getIdAttribute();
1640     if (!idValue.isNull()) {
1641         if (newScope)
1642             updateIdForTreeScope(*newScope, nullAtom(), idValue);
1643         if (newDocument)
1644             updateIdForDocument(*newDocument, nullAtom(), idValue, AlwaysUpdateHTMLDocumentNamedItemMaps);
1645     }
1646
1647     const AtomicString& nameValue = getNameAttribute();
1648     if (!nameValue.isNull()) {
1649         if (newScope)
1650             updateNameForTreeScope(*newScope, nullAtom(), nameValue);
1651         if (newDocument)
1652             updateNameForDocument(*newDocument, nullAtom(), nameValue);
1653     }
1654
1655     if (newScope && hasTagName(labelTag)) {
1656         if (newScope->shouldCacheLabelsByForAttribute())
1657             updateLabel(*newScope, nullAtom(), attributeWithoutSynchronization(forAttr));
1658     }
1659
1660     if (becomeConnected) {
1661         if (UNLIKELY(isCustomElementUpgradeCandidate()))
1662             CustomElementReactionQueue::enqueueElementUpgradeIfDefined(*this);
1663         if (UNLIKELY(isDefinedCustomElement()))
1664             CustomElementReactionQueue::enqueueConnectedCallbackIfNeeded(*this);
1665     }
1666
1667     return InsertionDone;
1668 }
1669
1670 void Element::removedFrom(ContainerNode& insertionPoint)
1671 {
1672 #if ENABLE(FULLSCREEN_API)
1673     if (containsFullScreenElement())
1674         setContainsFullScreenElementOnAncestorsCrossingFrameBoundaries(false);
1675 #endif
1676 #if ENABLE(POINTER_LOCK)
1677     if (document().page())
1678         document().page()->pointerLockController().elementRemoved(*this);
1679 #endif
1680
1681     setSavedLayerScrollPosition(ScrollPosition());
1682
1683     if (insertionPoint.isInTreeScope()) {
1684         TreeScope* oldScope = &insertionPoint.treeScope();
1685         bool becomeDisconnected = isConnected();
1686         HTMLDocument* oldDocument = becomeDisconnected && is<HTMLDocument>(oldScope->documentScope()) ? &downcast<HTMLDocument>(oldScope->documentScope()) : nullptr;
1687
1688         // ContainerNode::removeBetween always sets the removed chid's tree scope to Document's but InTreeScope flag is unset in Node::removedFrom.
1689         // So this element has been removed from the old tree scope only if InTreeScope flag is set and this element's tree scope is Document's.
1690         if (!isInTreeScope() || &treeScope() != &document())
1691             oldScope = nullptr;
1692
1693         const AtomicString& idValue = getIdAttribute();
1694         if (!idValue.isNull()) {
1695             if (oldScope)
1696                 updateIdForTreeScope(*oldScope, idValue, nullAtom());
1697             if (oldDocument)
1698                 updateIdForDocument(*oldDocument, idValue, nullAtom(), AlwaysUpdateHTMLDocumentNamedItemMaps);
1699         }
1700
1701         const AtomicString& nameValue = getNameAttribute();
1702         if (!nameValue.isNull()) {
1703             if (oldScope)
1704                 updateNameForTreeScope(*oldScope, nameValue, nullAtom());
1705             if (oldDocument)
1706                 updateNameForDocument(*oldDocument, nameValue, nullAtom());
1707         }
1708
1709         if (oldScope && hasTagName(labelTag)) {
1710             if (oldScope->shouldCacheLabelsByForAttribute())
1711                 updateLabel(*oldScope, attributeWithoutSynchronization(forAttr), nullAtom());
1712         }
1713
1714         if (becomeDisconnected && UNLIKELY(isDefinedCustomElement()))
1715             CustomElementReactionQueue::enqueueDisconnectedCallbackIfNeeded(*this);
1716     }
1717
1718     if (!parentNode()) {
1719         if (auto* shadowRoot = insertionPoint.shadowRoot())
1720             shadowRoot->hostChildElementDidChange(*this);
1721     }
1722
1723     ContainerNode::removedFrom(insertionPoint);
1724
1725     if (hasPendingResources())
1726         document().accessSVGExtensions().removeElementFromPendingResources(this);
1727
1728
1729 #if PLATFORM(MAC)
1730     if (Frame* frame = document().frame())
1731         frame->mainFrame().removeLatchingStateForTarget(*this);
1732 #endif
1733 }
1734
1735 void Element::unregisterNamedFlowContentElement()
1736 {
1737     if (isNamedFlowContentElement() && document().renderView())
1738         document().renderView()->flowThreadController().unregisterNamedFlowContentElement(*this);
1739 }
1740
1741 ShadowRoot* Element::shadowRoot() const
1742 {
1743     return hasRareData() ? elementRareData()->shadowRoot() : nullptr;
1744 }
1745
1746 void Element::addShadowRoot(Ref<ShadowRoot>&& newShadowRoot)
1747 {
1748     ASSERT(!shadowRoot());
1749     
1750     if (renderer())
1751         RenderTreeUpdater::tearDownRenderers(*this);
1752
1753     ShadowRoot& shadowRoot = newShadowRoot;
1754     ensureElementRareData().setShadowRoot(WTFMove(newShadowRoot));
1755
1756     shadowRoot.setHost(this);
1757     shadowRoot.setParentTreeScope(treeScope());
1758
1759     NodeVector postInsertionNotificationTargets;
1760     notifyChildNodeInserted(*this, shadowRoot, postInsertionNotificationTargets);
1761     for (auto& target : postInsertionNotificationTargets)
1762         target->finishedInsertingSubtree();
1763
1764     invalidateStyleAndRenderersForSubtree();
1765
1766     InspectorInstrumentation::didPushShadowRoot(*this, shadowRoot);
1767
1768     if (shadowRoot.mode() == ShadowRootMode::UserAgent)
1769         didAddUserAgentShadowRoot(&shadowRoot);
1770 }
1771
1772 void Element::removeShadowRoot()
1773 {
1774     RefPtr<ShadowRoot> oldRoot = shadowRoot();
1775     if (!oldRoot)
1776         return;
1777
1778     InspectorInstrumentation::willPopShadowRoot(*this, *oldRoot);
1779     document().removeFocusedNodeOfSubtree(*oldRoot);
1780
1781     ASSERT(!oldRoot->renderer());
1782
1783     elementRareData()->clearShadowRoot();
1784
1785     oldRoot->setHost(nullptr);
1786     oldRoot->setParentTreeScope(document());
1787 }
1788
1789 static bool canAttachAuthorShadowRoot(const Element& element)
1790 {
1791     static NeverDestroyed<HashSet<AtomicString>> tagNames = [] {
1792         static const HTMLQualifiedName* const tagList[] = {
1793             &articleTag,
1794             &asideTag,
1795             &blockquoteTag,
1796             &bodyTag,
1797             &divTag,
1798             &footerTag,
1799             &h1Tag,
1800             &h2Tag,
1801             &h3Tag,
1802             &h4Tag,
1803             &h5Tag,
1804             &h6Tag,
1805             &headerTag,
1806             &navTag,
1807             &pTag,
1808             &sectionTag,
1809             &spanTag
1810         };
1811         HashSet<AtomicString> set;
1812         for (auto& name : tagList)
1813             set.add(name->localName());
1814         return set;
1815     }();
1816
1817     if (!is<HTMLElement>(element))
1818         return false;
1819
1820     const auto& localName = element.localName();
1821     return tagNames.get().contains(localName) || Document::validateCustomElementName(localName) == CustomElementNameValidationStatus::Valid;
1822 }
1823
1824 ExceptionOr<ShadowRoot&> Element::attachShadow(const ShadowRootInit& init)
1825 {
1826     if (!canAttachAuthorShadowRoot(*this))
1827         return Exception { NOT_SUPPORTED_ERR };
1828     if (shadowRoot())
1829         return Exception { INVALID_STATE_ERR };
1830     if (init.mode == ShadowRootMode::UserAgent)
1831         return Exception { TypeError };
1832     auto shadow = ShadowRoot::create(document(), init.mode);
1833     auto& result = shadow.get();
1834     addShadowRoot(WTFMove(shadow));
1835     return result;
1836 }
1837
1838 ShadowRoot* Element::shadowRootForBindings(JSC::ExecState& state) const
1839 {
1840     auto* shadow = shadowRoot();
1841     if (!shadow)
1842         return nullptr;
1843     if (shadow->mode() == ShadowRootMode::Open)
1844         return shadow;
1845     if (JSC::jsCast<JSDOMGlobalObject*>(state.lexicalGlobalObject())->world().shadowRootIsAlwaysOpen())
1846         return shadow;
1847     return nullptr;
1848 }
1849
1850 ShadowRoot* Element::userAgentShadowRoot() const
1851 {
1852     ASSERT(!shadowRoot() || shadowRoot()->mode() == ShadowRootMode::UserAgent);
1853     return shadowRoot();
1854 }
1855
1856 ShadowRoot& Element::ensureUserAgentShadowRoot()
1857 {
1858     if (auto* shadow = userAgentShadowRoot())
1859         return *shadow;
1860     auto newShadow = ShadowRoot::create(document(), ShadowRootMode::UserAgent);
1861     ShadowRoot& shadow = newShadow;
1862     addShadowRoot(WTFMove(newShadow));
1863     return shadow;
1864 }
1865
1866 void Element::setIsDefinedCustomElement(JSCustomElementInterface& elementInterface)
1867 {
1868     clearFlag(IsEditingTextOrUndefinedCustomElementFlag);
1869     setFlag(IsCustomElement);
1870     auto& data = ensureElementRareData();
1871     if (!data.customElementReactionQueue())
1872         data.setCustomElementReactionQueue(std::make_unique<CustomElementReactionQueue>(elementInterface));
1873     InspectorInstrumentation::didChangeCustomElementState(*this);
1874 }
1875
1876 void Element::setIsFailedCustomElement(JSCustomElementInterface&)
1877 {
1878     ASSERT(isUndefinedCustomElement());
1879     ASSERT(getFlag(IsEditingTextOrUndefinedCustomElementFlag));
1880     clearFlag(IsCustomElement);
1881
1882     if (hasRareData()) {
1883         // Clear the queue instead of deleting it since this function can be called inside CustomElementReactionQueue::invokeAll during upgrades.
1884         if (auto* queue = elementRareData()->customElementReactionQueue())
1885             queue->clear();
1886     }
1887     InspectorInstrumentation::didChangeCustomElementState(*this);
1888 }
1889
1890 void Element::setIsCustomElementUpgradeCandidate()
1891 {
1892     ASSERT(!getFlag(IsCustomElement));
1893     setFlag(IsCustomElement);
1894     setFlag(IsEditingTextOrUndefinedCustomElementFlag);
1895     InspectorInstrumentation::didChangeCustomElementState(*this);
1896 }
1897
1898 void Element::enqueueToUpgrade(JSCustomElementInterface& elementInterface)
1899 {
1900     ASSERT(!isDefinedCustomElement() && !isFailedCustomElement());
1901     setFlag(IsCustomElement);
1902     setFlag(IsEditingTextOrUndefinedCustomElementFlag);
1903     InspectorInstrumentation::didChangeCustomElementState(*this);
1904
1905     auto& data = ensureElementRareData();
1906     ASSERT(!data.customElementReactionQueue());
1907
1908     data.setCustomElementReactionQueue(std::make_unique<CustomElementReactionQueue>(elementInterface));
1909     data.customElementReactionQueue()->enqueueElementUpgrade(*this);
1910 }
1911
1912 CustomElementReactionQueue* Element::reactionQueue() const
1913 {
1914     ASSERT(isDefinedCustomElement() || isCustomElementUpgradeCandidate());
1915     if (!hasRareData())
1916         return nullptr;
1917     return elementRareData()->customElementReactionQueue();
1918 }
1919
1920 const AtomicString& Element::shadowPseudoId() const
1921 {
1922     return pseudo();
1923 }
1924
1925 bool Element::childTypeAllowed(NodeType type) const
1926 {
1927     switch (type) {
1928     case ELEMENT_NODE:
1929     case TEXT_NODE:
1930     case COMMENT_NODE:
1931     case PROCESSING_INSTRUCTION_NODE:
1932     case CDATA_SECTION_NODE:
1933         return true;
1934     default:
1935         break;
1936     }
1937     return false;
1938 }
1939
1940 static void checkForEmptyStyleChange(Element& element)
1941 {
1942     if (element.styleAffectedByEmpty()) {
1943         auto* style = element.renderStyle();
1944         if (!style || (!style->emptyState() || element.hasChildNodes()))
1945             element.invalidateStyleForSubtree();
1946     }
1947 }
1948
1949 enum SiblingCheckType { FinishedParsingChildren, SiblingElementRemoved, Other };
1950
1951 static void checkForSiblingStyleChanges(Element& parent, SiblingCheckType checkType, Element* elementBeforeChange, Element* elementAfterChange)
1952 {
1953     // :empty selector.
1954     checkForEmptyStyleChange(parent);
1955
1956     if (parent.styleValidity() >= Style::Validity::SubtreeInvalid)
1957         return;
1958
1959     // :first-child.  In the parser callback case, we don't have to check anything, since we were right the first time.
1960     // In the DOM case, we only need to do something if |afterChange| is not 0.
1961     // |afterChange| is 0 in the parser case, so it works out that we'll skip this block.
1962     if (parent.childrenAffectedByFirstChildRules() && elementAfterChange) {
1963         // Find our new first child.
1964         Element* newFirstElement = ElementTraversal::firstChild(parent);
1965         // Find the first element node following |afterChange|
1966
1967         // This is the insert/append case.
1968         if (newFirstElement != elementAfterChange) {
1969             auto* style = elementAfterChange->renderStyle();
1970             if (!style || style->firstChildState())
1971                 elementAfterChange->invalidateStyleForSubtree();
1972         }
1973
1974         // We also have to handle node removal.
1975         if (checkType == SiblingElementRemoved && newFirstElement == elementAfterChange && newFirstElement) {
1976             auto* style = newFirstElement->renderStyle();
1977             if (!style || !style->firstChildState())
1978                 newFirstElement->invalidateStyleForSubtree();
1979         }
1980     }
1981
1982     // :last-child.  In the parser callback case, we don't have to check anything, since we were right the first time.
1983     // In the DOM case, we only need to do something if |afterChange| is not 0.
1984     if (parent.childrenAffectedByLastChildRules() && elementBeforeChange) {
1985         // Find our new last child.
1986         Element* newLastElement = ElementTraversal::lastChild(parent);
1987
1988         if (newLastElement != elementBeforeChange) {
1989             auto* style = elementBeforeChange->renderStyle();
1990             if (!style || style->lastChildState())
1991                 elementBeforeChange->invalidateStyleForSubtree();
1992         }
1993
1994         // We also have to handle node removal.  The parser callback case is similar to node removal as well in that we need to change the last child
1995         // to match now.
1996         if ((checkType == SiblingElementRemoved || checkType == FinishedParsingChildren) && newLastElement == elementBeforeChange && newLastElement) {
1997             auto* style = newLastElement->renderStyle();
1998             if (!style || !style->lastChildState())
1999                 newLastElement->invalidateStyleForSubtree();
2000         }
2001     }
2002
2003     if (elementAfterChange) {
2004         if (elementAfterChange->styleIsAffectedByPreviousSibling())
2005             elementAfterChange->invalidateStyleForSubtree();
2006         else if (elementAfterChange->affectsNextSiblingElementStyle()) {
2007             Element* elementToInvalidate = elementAfterChange;
2008             do {
2009                 elementToInvalidate = elementToInvalidate->nextElementSibling();
2010             } while (elementToInvalidate && !elementToInvalidate->styleIsAffectedByPreviousSibling());
2011
2012             if (elementToInvalidate)
2013                 elementToInvalidate->invalidateStyleForSubtree();
2014         }
2015     }
2016
2017     // Backward positional selectors include nth-last-child, nth-last-of-type, last-of-type and only-of-type.
2018     // We have to invalidate everything following the insertion point in the forward case, and everything before the insertion point in the
2019     // backward case.
2020     // |afterChange| is 0 in the parser callback case, so we won't do any work for the forward case if we don't have to.
2021     // For performance reasons we just mark the parent node as changed, since we don't want to make childrenChanged O(n^2) by crawling all our kids
2022     // here.  recalcStyle will then force a walk of the children when it sees that this has happened.
2023     if (parent.childrenAffectedByBackwardPositionalRules() && elementBeforeChange)
2024         parent.invalidateStyleForSubtree();
2025 }
2026
2027 void Element::childrenChanged(const ChildChange& change)
2028 {
2029     ContainerNode::childrenChanged(change);
2030     if (change.source == ChildChangeSourceParser)
2031         checkForEmptyStyleChange(*this);
2032     else {
2033         SiblingCheckType checkType = change.type == ElementRemoved ? SiblingElementRemoved : Other;
2034         checkForSiblingStyleChanges(*this, checkType, change.previousSiblingElement, change.nextSiblingElement);
2035     }
2036
2037     if (ShadowRoot* shadowRoot = this->shadowRoot()) {
2038         switch (change.type) {
2039         case ElementInserted:
2040         case ElementRemoved:
2041             // For elements, we notify shadowRoot in Element::insertedInto and Element::removedFrom.
2042             break;
2043         case AllChildrenRemoved:
2044         case AllChildrenReplaced:
2045             shadowRoot->didRemoveAllChildrenOfShadowHost();
2046             break;
2047         case TextInserted:
2048         case TextRemoved:
2049         case TextChanged:
2050             shadowRoot->didChangeDefaultSlot();
2051             break;
2052         case NonContentsChildInserted:
2053         case NonContentsChildRemoved:
2054             break;
2055         }
2056     }
2057 }
2058
2059 void Element::setAttributeEventListener(const AtomicString& eventType, const QualifiedName& attributeName, const AtomicString& attributeValue)
2060 {
2061     setAttributeEventListener(eventType, JSLazyEventListener::create(*this, attributeName, attributeValue), mainThreadNormalWorld());
2062 }
2063
2064 void Element::setIsNamedFlowContentElement()
2065 {
2066     ensureElementRareData().setIsNamedFlowContentElement(true);
2067 }
2068
2069 void Element::clearIsNamedFlowContentElement()
2070 {
2071     ensureElementRareData().setIsNamedFlowContentElement(false);
2072 }
2073
2074 void Element::removeAllEventListeners()
2075 {
2076     ContainerNode::removeAllEventListeners();
2077     if (ShadowRoot* shadowRoot = this->shadowRoot())
2078         shadowRoot->removeAllEventListeners();
2079 }
2080
2081 void Element::beginParsingChildren()
2082 {
2083     clearIsParsingChildrenFinished();
2084 }
2085
2086 void Element::finishParsingChildren()
2087 {
2088     ContainerNode::finishParsingChildren();
2089     setIsParsingChildrenFinished();
2090     checkForSiblingStyleChanges(*this, FinishedParsingChildren, ElementTraversal::lastChild(*this), nullptr);
2091 }
2092
2093 #if ENABLE(TREE_DEBUGGING)
2094 void Element::formatForDebugger(char* buffer, unsigned length) const
2095 {
2096     StringBuilder result;
2097     String s;
2098
2099     result.append(nodeName());
2100
2101     s = getIdAttribute();
2102     if (s.length() > 0) {
2103         if (result.length() > 0)
2104             result.appendLiteral("; ");
2105         result.appendLiteral("id=");
2106         result.append(s);
2107     }
2108
2109     s = getAttribute(classAttr);
2110     if (s.length() > 0) {
2111         if (result.length() > 0)
2112             result.appendLiteral("; ");
2113         result.appendLiteral("class=");
2114         result.append(s);
2115     }
2116
2117     strncpy(buffer, result.toString().utf8().data(), length - 1);
2118 }
2119 #endif
2120
2121 const Vector<RefPtr<Attr>>& Element::attrNodeList()
2122 {
2123     ASSERT(hasSyntheticAttrChildNodes());
2124     return *attrNodeListForElement(*this);
2125 }
2126
2127 void Element::attachAttributeNodeIfNeeded(Attr& attrNode)
2128 {
2129     ASSERT(!attrNode.ownerElement() || attrNode.ownerElement() == this);
2130     if (attrNode.ownerElement() == this)
2131         return;
2132
2133     NoEventDispatchAssertion assertNoEventDispatch;
2134
2135     attrNode.attachToElement(*this);
2136     ensureAttrNodeListForElement(*this).append(&attrNode);
2137 }
2138
2139 ExceptionOr<RefPtr<Attr>> Element::setAttributeNode(Attr& attrNode)
2140 {
2141     RefPtr<Attr> oldAttrNode = attrIfExists(attrNode.localName(), shouldIgnoreAttributeCase(*this));
2142     if (oldAttrNode.get() == &attrNode)
2143         return WTFMove(oldAttrNode);
2144
2145     // INUSE_ATTRIBUTE_ERR: Raised if node is an Attr that is already an attribute of another Element object.
2146     // The DOM user must explicitly clone Attr nodes to re-use them in other elements.
2147     if (attrNode.ownerElement() && attrNode.ownerElement() != this)
2148         return Exception { INUSE_ATTRIBUTE_ERR };
2149
2150     {
2151     NoEventDispatchAssertion assertNoEventDispatch;
2152     synchronizeAllAttributes();
2153     }
2154
2155     auto& elementData = ensureUniqueElementData();
2156
2157     auto existingAttributeIndex = elementData.findAttributeIndexByName(attrNode.localName(), shouldIgnoreAttributeCase(*this));
2158
2159     // Attr::value() will return its 'm_standaloneValue' member any time its Element is set to nullptr. We need to cache this value
2160     // before making changes to attrNode's Element connections.
2161     auto attrNodeValue = attrNode.value();
2162
2163     if (existingAttributeIndex == ElementData::attributeNotFound) {
2164         attachAttributeNodeIfNeeded(attrNode);
2165         setAttributeInternal(elementData.findAttributeIndexByName(attrNode.qualifiedName()), attrNode.qualifiedName(), attrNodeValue, NotInSynchronizationOfLazyAttribute);
2166     } else {
2167         const Attribute& attribute = attributeAt(existingAttributeIndex);
2168         if (oldAttrNode)
2169             detachAttrNodeFromElementWithValue(oldAttrNode.get(), attribute.value());
2170         else
2171             oldAttrNode = Attr::create(document(), attrNode.qualifiedName(), attribute.value());
2172
2173         attachAttributeNodeIfNeeded(attrNode);
2174
2175         if (attribute.name().matches(attrNode.qualifiedName()))
2176             setAttributeInternal(existingAttributeIndex, attrNode.qualifiedName(), attrNodeValue, NotInSynchronizationOfLazyAttribute);
2177         else {
2178             removeAttributeInternal(existingAttributeIndex, NotInSynchronizationOfLazyAttribute);
2179             setAttributeInternal(ensureUniqueElementData().findAttributeIndexByName(attrNode.qualifiedName()), attrNode.qualifiedName(), attrNodeValue, NotInSynchronizationOfLazyAttribute);
2180         }
2181     }
2182
2183     return WTFMove(oldAttrNode);
2184 }
2185
2186 ExceptionOr<RefPtr<Attr>> Element::setAttributeNodeNS(Attr& attrNode)
2187 {
2188     RefPtr<Attr> oldAttrNode = attrIfExists(attrNode.qualifiedName());
2189     if (oldAttrNode.get() == &attrNode)
2190         return WTFMove(oldAttrNode);
2191
2192     // INUSE_ATTRIBUTE_ERR: Raised if node is an Attr that is already an attribute of another Element object.
2193     // The DOM user must explicitly clone Attr nodes to re-use them in other elements.
2194     if (attrNode.ownerElement() && attrNode.ownerElement() != this)
2195         return Exception { INUSE_ATTRIBUTE_ERR };
2196
2197     unsigned index = 0;
2198     
2199     // Attr::value() will return its 'm_standaloneValue' member any time its Element is set to nullptr. We need to cache this value
2200     // before making changes to attrNode's Element connections.
2201     auto attrNodeValue = attrNode.value();
2202
2203     {
2204     NoEventDispatchAssertion assertNoEventDispatch;
2205     synchronizeAllAttributes();
2206     auto& elementData = ensureUniqueElementData();
2207
2208     index = elementData.findAttributeIndexByName(attrNode.qualifiedName());
2209
2210     if (index != ElementData::attributeNotFound) {
2211         if (oldAttrNode)
2212             detachAttrNodeFromElementWithValue(oldAttrNode.get(), elementData.attributeAt(index).value());
2213         else
2214             oldAttrNode = Attr::create(document(), attrNode.qualifiedName(), elementData.attributeAt(index).value());
2215     }
2216     }
2217
2218     attachAttributeNodeIfNeeded(attrNode);
2219     setAttributeInternal(index, attrNode.qualifiedName(), attrNodeValue, NotInSynchronizationOfLazyAttribute);
2220
2221     return WTFMove(oldAttrNode);
2222 }
2223
2224 ExceptionOr<Ref<Attr>> Element::removeAttributeNode(Attr& attr)
2225 {
2226     if (attr.ownerElement() != this)
2227         return Exception { NOT_FOUND_ERR };
2228
2229     ASSERT(&document() == &attr.document());
2230
2231     synchronizeAllAttributes();
2232
2233     if (!m_elementData)
2234         return Exception { NOT_FOUND_ERR };
2235
2236     auto existingAttributeIndex = m_elementData->findAttributeIndexByName(attr.qualifiedName());
2237     if (existingAttributeIndex == ElementData::attributeNotFound)
2238         return Exception { NOT_FOUND_ERR };
2239
2240     Ref<Attr> oldAttrNode { attr };
2241
2242     detachAttrNodeFromElementWithValue(&attr, m_elementData->attributeAt(existingAttributeIndex).value());
2243     removeAttributeInternal(existingAttributeIndex, NotInSynchronizationOfLazyAttribute);
2244
2245     return WTFMove(oldAttrNode);
2246 }
2247
2248 ExceptionOr<QualifiedName> Element::parseAttributeName(const AtomicString& namespaceURI, const AtomicString& qualifiedName)
2249 {
2250     auto parseResult = Document::parseQualifiedName(namespaceURI, qualifiedName);
2251     if (parseResult.hasException())
2252         return parseResult.releaseException();
2253     QualifiedName parsedAttributeName { parseResult.releaseReturnValue() };
2254     if (!Document::hasValidNamespaceForAttributes(parsedAttributeName))
2255         return Exception { NAMESPACE_ERR };
2256     return WTFMove(parsedAttributeName);
2257 }
2258
2259 ExceptionOr<void> Element::setAttributeNS(const AtomicString& namespaceURI, const AtomicString& qualifiedName, const AtomicString& value)
2260 {
2261     auto result = parseAttributeName(namespaceURI, qualifiedName);
2262     if (result.hasException())
2263         return result.releaseException();
2264     setAttribute(result.releaseReturnValue(), value);
2265     return { };
2266 }
2267
2268 void Element::removeAttributeInternal(unsigned index, SynchronizationOfLazyAttribute inSynchronizationOfLazyAttribute)
2269 {
2270     ASSERT_WITH_SECURITY_IMPLICATION(index < attributeCount());
2271
2272     UniqueElementData& elementData = ensureUniqueElementData();
2273
2274     QualifiedName name = elementData.attributeAt(index).name();
2275     AtomicString valueBeingRemoved = elementData.attributeAt(index).value();
2276
2277     if (RefPtr<Attr> attrNode = attrIfExists(name))
2278         detachAttrNodeFromElementWithValue(attrNode.get(), elementData.attributeAt(index).value());
2279
2280     if (inSynchronizationOfLazyAttribute) {
2281         elementData.removeAttribute(index);
2282         return;
2283     }
2284
2285     if (!valueBeingRemoved.isNull())
2286         willModifyAttribute(name, valueBeingRemoved, nullAtom());
2287
2288     {
2289         Style::AttributeChangeInvalidation styleInvalidation(*this, name, valueBeingRemoved, nullAtom());
2290         elementData.removeAttribute(index);
2291     }
2292
2293     didRemoveAttribute(name, valueBeingRemoved);
2294 }
2295
2296 void Element::addAttributeInternal(const QualifiedName& name, const AtomicString& value, SynchronizationOfLazyAttribute inSynchronizationOfLazyAttribute)
2297 {
2298     if (inSynchronizationOfLazyAttribute) {
2299         ensureUniqueElementData().addAttribute(name, value);
2300         return;
2301     }
2302
2303     willModifyAttribute(name, nullAtom(), value);
2304     {
2305         Style::AttributeChangeInvalidation styleInvalidation(*this, name, nullAtom(), value);
2306         ensureUniqueElementData().addAttribute(name, value);
2307     }
2308     didAddAttribute(name, value);
2309 }
2310
2311 bool Element::removeAttribute(const AtomicString& name)
2312 {
2313     if (!elementData())
2314         return false;
2315
2316     AtomicString localName = shouldIgnoreAttributeCase(*this) ? name.convertToASCIILowercase() : name;
2317     unsigned index = elementData()->findAttributeIndexByName(localName, false);
2318     if (index == ElementData::attributeNotFound) {
2319         if (UNLIKELY(localName == styleAttr) && elementData()->styleAttributeIsDirty() && is<StyledElement>(*this))
2320             downcast<StyledElement>(*this).removeAllInlineStyleProperties();
2321         return false;
2322     }
2323
2324     removeAttributeInternal(index, NotInSynchronizationOfLazyAttribute);
2325     return true;
2326 }
2327
2328 bool Element::removeAttributeNS(const AtomicString& namespaceURI, const AtomicString& localName)
2329 {
2330     return removeAttribute(QualifiedName(nullAtom(), localName, namespaceURI));
2331 }
2332
2333 RefPtr<Attr> Element::getAttributeNode(const AtomicString& localName)
2334 {
2335     if (!elementData())
2336         return nullptr;
2337     synchronizeAttribute(localName);
2338     const Attribute* attribute = elementData()->findAttributeByName(localName, shouldIgnoreAttributeCase(*this));
2339     if (!attribute)
2340         return nullptr;
2341     return ensureAttr(attribute->name());
2342 }
2343
2344 RefPtr<Attr> Element::getAttributeNodeNS(const AtomicString& namespaceURI, const AtomicString& localName)
2345 {
2346     if (!elementData())
2347         return 0;
2348     QualifiedName qName(nullAtom(), localName, namespaceURI);
2349     synchronizeAttribute(qName);
2350     const Attribute* attribute = elementData()->findAttributeByName(qName);
2351     if (!attribute)
2352         return 0;
2353     return ensureAttr(attribute->name());
2354 }
2355
2356 bool Element::hasAttribute(const AtomicString& localName) const
2357 {
2358     if (!elementData())
2359         return false;
2360     synchronizeAttribute(localName);
2361     return elementData()->findAttributeByName(localName, shouldIgnoreAttributeCase(*this));
2362 }
2363
2364 bool Element::hasAttributeNS(const AtomicString& namespaceURI, const AtomicString& localName) const
2365 {
2366     if (!elementData())
2367         return false;
2368     QualifiedName qName(nullAtom(), localName, namespaceURI);
2369     synchronizeAttribute(qName);
2370     return elementData()->findAttributeByName(qName);
2371 }
2372
2373 void Element::focus(bool restorePreviousSelection, FocusDirection direction)
2374 {
2375     if (!isConnected())
2376         return;
2377
2378     if (document().focusedElement() == this) {
2379         if (document().page())
2380             document().page()->chrome().client().elementDidRefocus(*this);
2381
2382         return;
2383     }
2384
2385     // If the stylesheets have already been loaded we can reliably check isFocusable.
2386     // If not, we continue and set the focused node on the focus controller below so
2387     // that it can be updated soon after attach. 
2388     if (document().haveStylesheetsLoaded()) {
2389         document().updateLayoutIgnorePendingStylesheets();
2390         if (!isFocusable())
2391             return;
2392     }
2393
2394     if (!supportsFocus())
2395         return;
2396
2397     RefPtr<Node> protect;
2398     if (Page* page = document().page()) {
2399         // Focus and change event handlers can cause us to lose our last ref.
2400         // If a focus event handler changes the focus to a different node it
2401         // does not make sense to continue and update appearence.
2402         protect = this;
2403         if (!page->focusController().setFocusedElement(this, *document().frame(), direction))
2404             return;
2405     }
2406
2407     // Setting the focused node above might have invalidated the layout due to scripts.
2408     document().updateLayoutIgnorePendingStylesheets();
2409
2410     if (!isFocusable()) {
2411         ensureElementRareData().setNeedsFocusAppearanceUpdateSoonAfterAttach(true);
2412         return;
2413     }
2414         
2415     cancelFocusAppearanceUpdate();
2416
2417     SelectionRevealMode revealMode = SelectionRevealMode::Reveal;
2418 #if PLATFORM(IOS)
2419     // Focusing a form element triggers animation in UIKit to scroll to the right position.
2420     // Calling updateFocusAppearance() would generate an unnecessary call to ScrollView::setScrollPosition(),
2421     // which would jump us around during this animation. See <rdar://problem/6699741>.
2422     bool isFormControl = is<HTMLFormControlElement>(*this);
2423     if (isFormControl)
2424         revealMode = SelectionRevealMode::RevealUpToMainFrame;
2425 #endif
2426
2427     updateFocusAppearance(restorePreviousSelection ? SelectionRestorationMode::Restore : SelectionRestorationMode::SetDefault, revealMode);
2428 }
2429
2430 void Element::updateFocusAppearanceAfterAttachIfNeeded()
2431 {
2432     if (!hasRareData())
2433         return;
2434     ElementRareData* data = elementRareData();
2435     if (!data->needsFocusAppearanceUpdateSoonAfterAttach())
2436         return;
2437     if (isFocusable() && document().focusedElement() == this)
2438         document().updateFocusAppearanceSoon(SelectionRestorationMode::SetDefault);
2439     data->setNeedsFocusAppearanceUpdateSoonAfterAttach(false);
2440 }
2441
2442 void Element::updateFocusAppearance(SelectionRestorationMode, SelectionRevealMode revealMode)
2443 {
2444     if (isRootEditableElement()) {
2445         // Keep frame alive in this method, since setSelection() may release the last reference to |frame|.
2446         RefPtr<Frame> frame = document().frame();
2447         if (!frame)
2448             return;
2449         
2450         // When focusing an editable element in an iframe, don't reset the selection if it already contains a selection.
2451         if (this == frame->selection().selection().rootEditableElement())
2452             return;
2453
2454         // FIXME: We should restore the previous selection if there is one.
2455         VisibleSelection newSelection = VisibleSelection(firstPositionInOrBeforeNode(this), DOWNSTREAM);
2456         
2457         if (frame->selection().shouldChangeSelection(newSelection)) {
2458             frame->selection().setSelection(newSelection, FrameSelection::defaultSetSelectionOptions(), Element::defaultFocusTextStateChangeIntent());
2459             frame->selection().revealSelection(revealMode);
2460         }
2461     } else if (renderer() && !renderer()->isWidget()) {
2462         bool insideFixed;
2463         LayoutRect absoluteBounds = renderer()->absoluteAnchorRect(&insideFixed);
2464         renderer()->scrollRectToVisible(revealMode, absoluteBounds, insideFixed);
2465     }
2466 }
2467
2468 void Element::blur()
2469 {
2470     cancelFocusAppearanceUpdate();
2471     if (treeScope().focusedElementInScope() == this) {
2472         if (Frame* frame = document().frame())
2473             frame->page()->focusController().setFocusedElement(nullptr, *frame);
2474         else
2475             document().setFocusedElement(nullptr);
2476     }
2477 }
2478
2479 void Element::dispatchFocusInEvent(const AtomicString& eventType, RefPtr<Element>&& oldFocusedElement)
2480 {
2481     ASSERT_WITH_SECURITY_IMPLICATION(NoEventDispatchAssertion::isEventAllowedInMainThread());
2482     ASSERT(eventType == eventNames().focusinEvent || eventType == eventNames().DOMFocusInEvent);
2483     dispatchScopedEvent(FocusEvent::create(eventType, true, false, document().defaultView(), 0, WTFMove(oldFocusedElement)));
2484 }
2485
2486 void Element::dispatchFocusOutEvent(const AtomicString& eventType, RefPtr<Element>&& newFocusedElement)
2487 {
2488     ASSERT_WITH_SECURITY_IMPLICATION(NoEventDispatchAssertion::isEventAllowedInMainThread());
2489     ASSERT(eventType == eventNames().focusoutEvent || eventType == eventNames().DOMFocusOutEvent);
2490     dispatchScopedEvent(FocusEvent::create(eventType, true, false, document().defaultView(), 0, WTFMove(newFocusedElement)));
2491 }
2492
2493 void Element::dispatchFocusEvent(RefPtr<Element>&& oldFocusedElement, FocusDirection)
2494 {
2495     if (document().page())
2496         document().page()->chrome().client().elementDidFocus(*this);
2497
2498     EventDispatcher::dispatchEvent(*this, FocusEvent::create(eventNames().focusEvent, false, false, document().defaultView(), 0, WTFMove(oldFocusedElement)));
2499 }
2500
2501 void Element::dispatchBlurEvent(RefPtr<Element>&& newFocusedElement)
2502 {
2503     if (document().page())
2504         document().page()->chrome().client().elementDidBlur(*this);
2505
2506     EventDispatcher::dispatchEvent(*this, FocusEvent::create(eventNames().blurEvent, false, false, document().defaultView(), 0, WTFMove(newFocusedElement)));
2507 }
2508
2509 void Element::dispatchWebKitImageReadyEventForTesting()
2510 {
2511     if (document().settings().webkitImageReadyEventEnabled())
2512         dispatchEvent(Event::create("webkitImageFrameReady", true, true));
2513 }
2514
2515 bool Element::dispatchMouseForceWillBegin()
2516 {
2517 #if ENABLE(MOUSE_FORCE_EVENTS)
2518     if (!document().hasListenerType(Document::FORCEWILLBEGIN_LISTENER))
2519         return false;
2520
2521     Frame* frame = document().frame();
2522     if (!frame)
2523         return false;
2524
2525     PlatformMouseEvent platformMouseEvent { frame->eventHandler().lastKnownMousePosition(), frame->eventHandler().lastKnownMouseGlobalPosition(), NoButton, PlatformEvent::NoType, 1, false, false, false, false, WTF::currentTime(), ForceAtClick, NoTap };
2526     auto mouseForceWillBeginEvent = MouseEvent::create(eventNames().webkitmouseforcewillbeginEvent, document().defaultView(), platformMouseEvent, 0, nullptr);
2527     mouseForceWillBeginEvent->setTarget(this);
2528     dispatchEvent(mouseForceWillBeginEvent);
2529
2530     if (mouseForceWillBeginEvent->defaultHandled() || mouseForceWillBeginEvent->defaultPrevented())
2531         return true;
2532 #endif
2533
2534     return false;
2535 }
2536
2537 ExceptionOr<void> Element::mergeWithNextTextNode(Text& node)
2538 {
2539     auto* next = node.nextSibling();
2540     if (!is<Text>(next))
2541         return { };
2542     Ref<Text> textNext { downcast<Text>(*next) };
2543     node.appendData(textNext->data());
2544     return textNext->remove();
2545 }
2546
2547 String Element::innerHTML() const
2548 {
2549     return createMarkup(*this, ChildrenOnly);
2550 }
2551
2552 String Element::outerHTML() const
2553 {
2554     return createMarkup(*this);
2555 }
2556
2557 ExceptionOr<void> Element::setOuterHTML(const String& html)
2558 {
2559     auto* parentElement = this->parentElement();
2560     if (!is<HTMLElement>(parentElement))
2561         return Exception { NO_MODIFICATION_ALLOWED_ERR };
2562
2563     Ref<HTMLElement> parent = downcast<HTMLElement>(*parentElement);
2564     RefPtr<Node> prev = previousSibling();
2565     RefPtr<Node> next = nextSibling();
2566
2567     auto fragment = createFragmentForInnerOuterHTML(parent, html, AllowScriptingContent);
2568     if (fragment.hasException())
2569         return fragment.releaseException();
2570
2571     auto replaceResult = parent->replaceChild(fragment.releaseReturnValue().get(), *this);
2572     if (replaceResult.hasException())
2573         return replaceResult.releaseException();
2574
2575     RefPtr<Node> node = next ? next->previousSibling() : nullptr;
2576     if (is<Text>(node.get())) {
2577         auto result = mergeWithNextTextNode(downcast<Text>(*node));
2578         if (result.hasException())
2579             return result.releaseException();
2580     }
2581     if (is<Text>(prev.get())) {
2582         auto result = mergeWithNextTextNode(downcast<Text>(*prev));
2583         if (result.hasException())
2584             return result.releaseException();
2585     }
2586     return { };
2587 }
2588
2589
2590 ExceptionOr<void> Element::setInnerHTML(const String& html)
2591 {
2592     auto fragment = createFragmentForInnerOuterHTML(*this, html, AllowScriptingContent);
2593     if (fragment.hasException())
2594         return fragment.releaseException();
2595
2596     ContainerNode* container;
2597     if (!is<HTMLTemplateElement>(*this))
2598         container = this;
2599     else
2600         container = &downcast<HTMLTemplateElement>(*this).content();
2601
2602     return replaceChildrenWithFragment(*container, fragment.releaseReturnValue());
2603 }
2604
2605 String Element::innerText()
2606 {
2607     // We need to update layout, since plainText uses line boxes in the render tree.
2608     document().updateLayoutIgnorePendingStylesheets();
2609
2610     if (!renderer())
2611         return textContent(true);
2612
2613     return plainText(rangeOfContents(*this).ptr());
2614 }
2615
2616 String Element::outerText()
2617 {
2618     // Getting outerText is the same as getting innerText, only
2619     // setting is different. You would think this should get the plain
2620     // text for the outer range, but this is wrong, <br> for instance
2621     // would return different values for inner and outer text by such
2622     // a rule, but it doesn't in WinIE, and we want to match that.
2623     return innerText();
2624 }
2625
2626 String Element::title() const
2627 {
2628     return String();
2629 }
2630
2631 const AtomicString& Element::pseudo() const
2632 {
2633     return attributeWithoutSynchronization(pseudoAttr);
2634 }
2635
2636 void Element::setPseudo(const AtomicString& value)
2637 {
2638     setAttributeWithoutSynchronization(pseudoAttr, value);
2639 }
2640
2641 LayoutSize Element::minimumSizeForResizing() const
2642 {
2643     return hasRareData() ? elementRareData()->minimumSizeForResizing() : defaultMinimumSizeForResizing();
2644 }
2645
2646 void Element::setMinimumSizeForResizing(const LayoutSize& size)
2647 {
2648     if (!hasRareData() && size == defaultMinimumSizeForResizing())
2649         return;
2650     ensureElementRareData().setMinimumSizeForResizing(size);
2651 }
2652
2653 void Element::willBecomeFullscreenElement()
2654 {
2655     for (auto& child : descendantsOfType<Element>(*this))
2656         child.ancestorWillEnterFullscreen();
2657 }
2658
2659 static PseudoElement* beforeOrAfterPseudoElement(Element& host, PseudoId pseudoElementSpecifier)
2660 {
2661     switch (pseudoElementSpecifier) {
2662     case BEFORE:
2663         return host.beforePseudoElement();
2664     case AFTER:
2665         return host.afterPseudoElement();
2666     default:
2667         return nullptr;
2668     }
2669 }
2670
2671 const RenderStyle* Element::existingComputedStyle()
2672 {
2673     if (auto* renderTreeStyle = renderStyle())
2674         return renderTreeStyle;
2675
2676     if (hasRareData())
2677         return elementRareData()->computedStyle();
2678
2679     return nullptr;
2680 }
2681
2682 const RenderStyle& Element::resolveComputedStyle()
2683 {
2684     ASSERT(isConnected());
2685     ASSERT(!existingComputedStyle());
2686
2687     Deque<Element*, 32> elementsRequiringComputedStyle({ this });
2688     const RenderStyle* computedStyle = nullptr;
2689
2690     // Collect ancestors until we find one that has style.
2691     auto composedAncestors = composedTreeAncestors(*this);
2692     for (auto& ancestor : composedAncestors) {
2693         if (auto* existingStyle = ancestor.existingComputedStyle()) {
2694             computedStyle = existingStyle;
2695             break;
2696         }
2697         elementsRequiringComputedStyle.prepend(&ancestor);
2698     }
2699
2700     // Resolve and cache styles starting from the most distant ancestor.
2701     for (auto* element : elementsRequiringComputedStyle) {
2702         auto style = document().styleForElementIgnoringPendingStylesheets(*element, computedStyle);
2703         computedStyle = style.get();
2704         ElementRareData& rareData = element->ensureElementRareData();
2705         rareData.setComputedStyle(WTFMove(style));
2706     }
2707
2708     return *computedStyle;
2709 }
2710
2711 const RenderStyle* Element::computedStyle(PseudoId pseudoElementSpecifier)
2712 {
2713     if (!isConnected())
2714         return nullptr;
2715
2716     if (PseudoElement* pseudoElement = beforeOrAfterPseudoElement(*this, pseudoElementSpecifier))
2717         return pseudoElement->computedStyle();
2718
2719     auto* style = existingComputedStyle();
2720     if (!style)
2721         style = &resolveComputedStyle();
2722
2723     if (pseudoElementSpecifier) {
2724         if (auto* cachedPseudoStyle = style->getCachedPseudoStyle(pseudoElementSpecifier))
2725             return cachedPseudoStyle;
2726     }
2727
2728     return style;
2729 }
2730
2731 bool Element::needsStyleInvalidation() const
2732 {
2733     if (!inRenderedDocument())
2734         return false;
2735     if (styleValidity() >= Style::Validity::SubtreeInvalid)
2736         return false;
2737     if (document().hasPendingForcedStyleRecalc())
2738         return false;
2739
2740     return true;
2741 }
2742
2743 void Element::setStyleAffectedByEmpty()
2744 {
2745     ensureElementRareData().setStyleAffectedByEmpty(true);
2746 }
2747
2748 void Element::setStyleAffectedByFocusWithin()
2749 {
2750     ensureElementRareData().setStyleAffectedByFocusWithin(true);
2751 }
2752
2753 void Element::setStyleAffectedByActive()
2754 {
2755     ensureElementRareData().setStyleAffectedByActive(true);
2756 }
2757
2758 void Element::setChildrenAffectedByDrag()
2759 {
2760     ensureElementRareData().setChildrenAffectedByDrag(true);
2761 }
2762
2763 void Element::setChildrenAffectedByBackwardPositionalRules()
2764 {
2765     ensureElementRareData().setChildrenAffectedByBackwardPositionalRules(true);
2766 }
2767
2768 void Element::setChildrenAffectedByPropertyBasedBackwardPositionalRules()
2769 {
2770     ensureElementRareData().setChildrenAffectedByPropertyBasedBackwardPositionalRules(true);
2771 }
2772
2773 void Element::setChildIndex(unsigned index)
2774 {
2775     ElementRareData& rareData = ensureElementRareData();
2776     rareData.setChildIndex(index);
2777 }
2778
2779 bool Element::hasFlagsSetDuringStylingOfChildren() const
2780 {
2781     if (childrenAffectedByHover() || childrenAffectedByFirstChildRules() || childrenAffectedByLastChildRules())
2782         return true;
2783
2784     if (!hasRareData())
2785         return false;
2786     return rareDataStyleAffectedByActive()
2787         || rareDataChildrenAffectedByDrag()
2788         || rareDataChildrenAffectedByBackwardPositionalRules()
2789         || rareDataChildrenAffectedByPropertyBasedBackwardPositionalRules();
2790 }
2791
2792 bool Element::rareDataStyleAffectedByEmpty() const
2793 {
2794     ASSERT(hasRareData());
2795     return elementRareData()->styleAffectedByEmpty();
2796 }
2797
2798 bool Element::rareDataStyleAffectedByFocusWithin() const
2799 {
2800     ASSERT(hasRareData());
2801     return elementRareData()->styleAffectedByFocusWithin();
2802 }
2803
2804 bool Element::rareDataIsNamedFlowContentElement() const
2805 {
2806     ASSERT(hasRareData());
2807     return elementRareData()->isNamedFlowContentElement();
2808 }
2809
2810 bool Element::rareDataStyleAffectedByActive() const
2811 {
2812     ASSERT(hasRareData());
2813     return elementRareData()->styleAffectedByActive();
2814 }
2815
2816 bool Element::rareDataChildrenAffectedByDrag() const
2817 {
2818     ASSERT(hasRareData());
2819     return elementRareData()->childrenAffectedByDrag();
2820 }
2821
2822 bool Element::rareDataChildrenAffectedByBackwardPositionalRules() const
2823 {
2824     ASSERT(hasRareData());
2825     return elementRareData()->childrenAffectedByBackwardPositionalRules();
2826 }
2827
2828 bool Element::rareDataChildrenAffectedByPropertyBasedBackwardPositionalRules() const
2829 {
2830     ASSERT(hasRareData());
2831     return elementRareData()->childrenAffectedByPropertyBasedBackwardPositionalRules();
2832 }
2833
2834 unsigned Element::rareDataChildIndex() const
2835 {
2836     ASSERT(hasRareData());
2837     return elementRareData()->childIndex();
2838 }
2839
2840 void Element::setRegionOversetState(RegionOversetState state)
2841 {
2842     ensureElementRareData().setRegionOversetState(state);
2843 }
2844
2845 RegionOversetState Element::regionOversetState() const
2846 {
2847     return hasRareData() ? elementRareData()->regionOversetState() : RegionUndefined;
2848 }
2849
2850 AtomicString Element::computeInheritedLanguage() const
2851 {
2852     if (const ElementData* elementData = this->elementData()) {
2853         if (const Attribute* attribute = elementData->findLanguageAttribute())
2854             return attribute->value();
2855     }
2856
2857     // The language property is inherited, so we iterate over the parents to find the first language.
2858     const Node* currentNode = this;
2859     while ((currentNode = currentNode->parentNode())) {
2860         if (is<Element>(*currentNode)) {
2861             if (const ElementData* elementData = downcast<Element>(*currentNode).elementData()) {
2862                 if (const Attribute* attribute = elementData->findLanguageAttribute())
2863                     return attribute->value();
2864             }
2865         } else if (is<Document>(*currentNode)) {
2866             // checking the MIME content-language
2867             return downcast<Document>(*currentNode).contentLanguage();
2868         }
2869     }
2870
2871     return nullAtom();
2872 }
2873
2874 Locale& Element::locale() const
2875 {
2876     return document().getCachedLocale(computeInheritedLanguage());
2877 }
2878
2879 void Element::cancelFocusAppearanceUpdate()
2880 {
2881     if (hasRareData())
2882         elementRareData()->setNeedsFocusAppearanceUpdateSoonAfterAttach(false);
2883     if (document().focusedElement() == this)
2884         document().cancelFocusAppearanceUpdate();
2885 }
2886
2887 void Element::normalizeAttributes()
2888 {
2889     if (!hasAttributes())
2890         return;
2891
2892     auto* attrNodeList = attrNodeListForElement(*this);
2893     if (!attrNodeList)
2894         return;
2895
2896     // Copy the Attr Vector because Node::normalize() can fire synchronous JS
2897     // events (e.g. DOMSubtreeModified) and a JS listener could add / remove
2898     // attributes while we are iterating.
2899     auto copyOfAttrNodeList = *attrNodeList;
2900     for (auto& attrNode : copyOfAttrNodeList)
2901         attrNode->normalize();
2902 }
2903
2904 PseudoElement* Element::beforePseudoElement() const
2905 {
2906     return hasRareData() ? elementRareData()->beforePseudoElement() : nullptr;
2907 }
2908
2909 PseudoElement* Element::afterPseudoElement() const
2910 {
2911     return hasRareData() ? elementRareData()->afterPseudoElement() : nullptr;
2912 }
2913
2914 void Element::setBeforePseudoElement(Ref<PseudoElement>&& element)
2915 {
2916     ensureElementRareData().setBeforePseudoElement(WTFMove(element));
2917 }
2918
2919 void Element::setAfterPseudoElement(Ref<PseudoElement>&& element)
2920 {
2921     ensureElementRareData().setAfterPseudoElement(WTFMove(element));
2922 }
2923
2924 static void disconnectPseudoElement(PseudoElement* pseudoElement)
2925 {
2926     if (!pseudoElement)
2927         return;
2928     if (pseudoElement->renderer())
2929         RenderTreeUpdater::tearDownRenderers(*pseudoElement);
2930     ASSERT(pseudoElement->hostElement());
2931     pseudoElement->clearHostElement();
2932 }
2933
2934 void Element::clearBeforePseudoElement()
2935 {
2936     if (!hasRareData())
2937         return;
2938     disconnectPseudoElement(elementRareData()->beforePseudoElement());
2939     elementRareData()->setBeforePseudoElement(nullptr);
2940 }
2941
2942 void Element::clearAfterPseudoElement()
2943 {
2944     if (!hasRareData())
2945         return;
2946     disconnectPseudoElement(elementRareData()->afterPseudoElement());
2947     elementRareData()->setAfterPseudoElement(nullptr);
2948 }
2949
2950 bool Element::matchesValidPseudoClass() const
2951 {
2952     return false;
2953 }
2954
2955 bool Element::matchesInvalidPseudoClass() const
2956 {
2957     return false;
2958 }
2959
2960 bool Element::matchesReadWritePseudoClass() const
2961 {
2962     return false;
2963 }
2964
2965 bool Element::matchesIndeterminatePseudoClass() const
2966 {
2967     return shouldAppearIndeterminate();
2968 }
2969
2970 bool Element::matchesDefaultPseudoClass() const
2971 {
2972     return false;
2973 }
2974
2975 ExceptionOr<bool> Element::matches(const String& selector)
2976 {
2977     auto query = document().selectorQueryForString(selector);
2978     if (query.hasException())
2979         return query.releaseException();
2980     return query.releaseReturnValue().matches(*this);
2981 }
2982
2983 ExceptionOr<Element*> Element::closest(const String& selector)
2984 {
2985     auto query = document().selectorQueryForString(selector);
2986     if (query.hasException())
2987         return query.releaseException();
2988     return query.releaseReturnValue().closest(*this);
2989 }
2990
2991 bool Element::shouldAppearIndeterminate() const
2992 {
2993     return false;
2994 }
2995
2996 bool Element::mayCauseRepaintInsideViewport(const IntRect* visibleRect) const
2997 {
2998     return renderer() && renderer()->mayCauseRepaintInsideViewport(visibleRect);
2999 }
3000
3001 DOMTokenList& Element::classList()
3002 {
3003     ElementRareData& data = ensureElementRareData();
3004     if (!data.classList())
3005         data.setClassList(std::make_unique<DOMTokenList>(*this, HTMLNames::classAttr));
3006     return *data.classList();
3007 }
3008
3009 DatasetDOMStringMap& Element::dataset()
3010 {
3011     ElementRareData& data = ensureElementRareData();
3012     if (!data.dataset())
3013         data.setDataset(std::make_unique<DatasetDOMStringMap>(*this));
3014     return *data.dataset();
3015 }
3016
3017 URL Element::getURLAttribute(const QualifiedName& name) const
3018 {
3019 #if !ASSERT_DISABLED
3020     if (elementData()) {
3021         if (const Attribute* attribute = findAttributeByName(name))
3022             ASSERT(isURLAttribute(*attribute));
3023     }
3024 #endif
3025     return document().completeURL(stripLeadingAndTrailingHTMLSpaces(getAttribute(name)));
3026 }
3027
3028 URL Element::getNonEmptyURLAttribute(const QualifiedName& name) const
3029 {
3030 #if !ASSERT_DISABLED
3031     if (elementData()) {
3032         if (const Attribute* attribute = findAttributeByName(name))
3033             ASSERT(isURLAttribute(*attribute));
3034     }
3035 #endif
3036     String value = stripLeadingAndTrailingHTMLSpaces(getAttribute(name));
3037     if (value.isEmpty())
3038         return URL();
3039     return document().completeURL(value);
3040 }
3041
3042 int Element::getIntegralAttribute(const QualifiedName& attributeName) const
3043 {
3044     return parseHTMLInteger(getAttribute(attributeName)).valueOr(0);
3045 }
3046
3047 void Element::setIntegralAttribute(const QualifiedName& attributeName, int value)
3048 {
3049     setAttribute(attributeName, AtomicString::number(value));
3050 }
3051
3052 unsigned Element::getUnsignedIntegralAttribute(const QualifiedName& attributeName) const
3053 {
3054     return parseHTMLNonNegativeInteger(getAttribute(attributeName)).valueOr(0);
3055 }
3056
3057 void Element::setUnsignedIntegralAttribute(const QualifiedName& attributeName, unsigned value)
3058 {
3059     setAttribute(attributeName, AtomicString::number(limitToOnlyHTMLNonNegative(value)));
3060 }
3061
3062 bool Element::childShouldCreateRenderer(const Node& child) const
3063 {
3064     // Only create renderers for SVG elements whose parents are SVG elements, or for proper <svg xmlns="svgNS"> subdocuments.
3065     if (child.isSVGElement()) {
3066         ASSERT(!isSVGElement());
3067         const SVGElement& childElement = downcast<SVGElement>(child);
3068         return is<SVGSVGElement>(childElement) && childElement.isValid();
3069     }
3070     return true;
3071 }
3072
3073 #if ENABLE(FULLSCREEN_API)
3074 void Element::webkitRequestFullscreen()
3075 {
3076     document().requestFullScreenForElement(this, Document::EnforceIFrameAllowFullScreenRequirement);
3077 }
3078
3079 bool Element::containsFullScreenElement() const
3080 {
3081     return hasRareData() && elementRareData()->containsFullScreenElement();
3082 }
3083
3084 void Element::setContainsFullScreenElement(bool flag)
3085 {
3086     ensureElementRareData().setContainsFullScreenElement(flag);
3087     invalidateStyleAndLayerComposition();
3088 }
3089
3090 static Element* parentCrossingFrameBoundaries(Element* element)
3091 {
3092     ASSERT(element);
3093     return element->parentElement() ? element->parentElement() : element->document().ownerElement();
3094 }
3095
3096 void Element::setContainsFullScreenElementOnAncestorsCrossingFrameBoundaries(bool flag)
3097 {
3098     Element* element = this;
3099     while ((element = parentCrossingFrameBoundaries(element)))
3100         element->setContainsFullScreenElement(flag);
3101 }
3102 #endif
3103
3104 #if ENABLE(POINTER_LOCK)
3105 void Element::requestPointerLock()
3106 {
3107     if (document().page())
3108         document().page()->pointerLockController().requestPointerLock(this);
3109 }
3110 #endif
3111
3112 SpellcheckAttributeState Element::spellcheckAttributeState() const
3113 {
3114     const AtomicString& value = attributeWithoutSynchronization(HTMLNames::spellcheckAttr);
3115     if (value.isNull())
3116         return SpellcheckAttributeDefault;
3117     if (value.isEmpty() || equalLettersIgnoringASCIICase(value, "true"))
3118         return SpellcheckAttributeTrue;
3119     if (equalLettersIgnoringASCIICase(value, "false"))
3120         return SpellcheckAttributeFalse;
3121     return SpellcheckAttributeDefault;
3122 }
3123
3124 bool Element::isSpellCheckingEnabled() const
3125 {
3126     for (const Element* element = this; element; element = element->parentOrShadowHostElement()) {
3127         switch (element->spellcheckAttributeState()) {
3128         case SpellcheckAttributeTrue:
3129             return true;
3130         case SpellcheckAttributeFalse:
3131             return false;
3132         case SpellcheckAttributeDefault:
3133             break;
3134         }
3135     }
3136
3137     return true;
3138 }
3139
3140 RenderNamedFlowFragment* Element::renderNamedFlowFragment() const
3141 {
3142     if (renderer() && renderer()->isRenderNamedFlowFragmentContainer())
3143         return downcast<RenderBlockFlow>(*renderer()).renderNamedFlowFragment();
3144
3145     return nullptr;
3146 }
3147
3148 #if ENABLE(CSS_REGIONS)
3149
3150 bool Element::shouldMoveToFlowThread(const RenderStyle& styleToUse) const
3151 {
3152 #if ENABLE(FULLSCREEN_API)
3153     if (document().webkitIsFullScreen() && document().webkitCurrentFullScreenElement() == this)
3154         return false;
3155 #endif
3156
3157     if (isInShadowTree())
3158         return false;
3159
3160     if (!styleToUse.hasFlowInto())
3161         return false;
3162
3163     return true;
3164 }
3165
3166 const AtomicString& Element::webkitRegionOverset() const
3167 {
3168     document().updateLayoutIgnorePendingStylesheets();
3169
3170     static NeverDestroyed<AtomicString> undefinedState("undefined", AtomicString::ConstructFromLiteral);
3171     if (!renderNamedFlowFragment())
3172         return undefinedState;
3173
3174     switch (regionOversetState()) {
3175     case RegionFit: {
3176         static NeverDestroyed<AtomicString> fitState("fit", AtomicString::ConstructFromLiteral);
3177         return fitState;
3178     }
3179     case RegionEmpty: {
3180         static NeverDestroyed<AtomicString> emptyState("empty", AtomicString::ConstructFromLiteral);
3181         return emptyState;
3182     }
3183     case RegionOverset: {
3184         static NeverDestroyed<AtomicString> overflowState("overset", AtomicString::ConstructFromLiteral);
3185         return overflowState;
3186     }
3187     case RegionUndefined:
3188         return undefinedState;
3189     }
3190
3191     ASSERT_NOT_REACHED();
3192     return undefinedState;
3193 }
3194
3195 Vector<RefPtr<Range>> Element::webkitGetRegionFlowRanges() const
3196 {
3197     Vector<RefPtr<Range>> rangeObjects;
3198     document().updateLayoutIgnorePendingStylesheets();
3199     auto* renderer = this->renderer();
3200     if (renderer && renderer->isRenderNamedFlowFragmentContainer()) {
3201         auto& namedFlowFragment = *downcast<RenderBlockFlow>(*renderer).renderNamedFlowFragment();
3202         if (namedFlowFragment.isValid())
3203             namedFlowFragment.getRanges(rangeObjects);
3204     }
3205     return rangeObjects;
3206 }
3207
3208 #endif
3209
3210 #ifndef NDEBUG
3211 bool Element::fastAttributeLookupAllowed(const QualifiedName& name) const
3212 {
3213     if (name == HTMLNames::styleAttr)
3214         return false;
3215
3216     if (isSVGElement())
3217         return !downcast<SVGElement>(*this).isAnimatableAttribute(name);
3218
3219     return true;
3220 }
3221 #endif
3222
3223 #ifdef DUMP_NODE_STATISTICS
3224 bool Element::hasNamedNodeMap() const
3225 {
3226     return hasRareData() && elementRareData()->attributeMap();
3227 }
3228 #endif
3229
3230 inline void Element::updateName(const AtomicString& oldName, const AtomicString& newName)
3231 {
3232     if (!isInTreeScope())
3233         return;
3234
3235     if (oldName == newName)
3236         return;
3237
3238     updateNameForTreeScope(treeScope(), oldName, newName);
3239
3240     if (!isConnected())
3241         return;
3242     if (!is<HTMLDocument>(document()))
3243         return;
3244     updateNameForDocument(downcast<HTMLDocument>(document()), oldName, newName);
3245 }
3246
3247 void Element::updateNameForTreeScope(TreeScope& scope, const AtomicString& oldName, const AtomicString& newName)
3248 {
3249     ASSERT(oldName != newName);
3250
3251     if (!oldName.isEmpty())
3252         scope.removeElementByName(*oldName.impl(), *this);
3253     if (!newName.isEmpty())
3254         scope.addElementByName(*newName.impl(), *this);
3255 }
3256
3257 void Element::updateNameForDocument(HTMLDocument& document, const AtomicString& oldName, const AtomicString& newName)
3258 {
3259     ASSERT(oldName != newName);
3260
3261     if (isInShadowTree())
3262         return;
3263
3264     if (WindowNameCollection::elementMatchesIfNameAttributeMatch(*this)) {
3265         const AtomicString& id = WindowNameCollection::elementMatchesIfIdAttributeMatch(*this) ? getIdAttribute() : nullAtom();
3266         if (!oldName.isEmpty() && oldName != id)
3267             document.removeWindowNamedItem(*oldName.impl(), *this);
3268         if (!newName.isEmpty() && newName != id)
3269             document.addWindowNamedItem(*newName.impl(), *this);
3270     }
3271
3272     if (DocumentNameCollection::elementMatchesIfNameAttributeMatch(*this)) {
3273         const AtomicString& id = DocumentNameCollection::elementMatchesIfIdAttributeMatch(*this) ? getIdAttribute() : nullAtom();
3274         if (!oldName.isEmpty() && oldName != id)
3275             document.removeDocumentNamedItem(*oldName.impl(), *this);
3276         if (!newName.isEmpty() && newName != id)
3277             document.addDocumentNamedItem(*newName.impl(), *this);
3278     }
3279 }
3280
3281 inline void Element::updateId(const AtomicString& oldId, const AtomicString& newId, NotifyObservers notifyObservers)
3282 {
3283     if (!isInTreeScope())
3284         return;
3285
3286     if (oldId == newId)
3287         return;
3288
3289     updateIdForTreeScope(treeScope(), oldId, newId, notifyObservers);
3290
3291     if (!isConnected())
3292         return;
3293     if (!is<HTMLDocument>(document()))
3294         return;
3295     updateIdForDocument(downcast<HTMLDocument>(document()), oldId, newId, UpdateHTMLDocumentNamedItemMapsOnlyIfDiffersFromNameAttribute);
3296 }
3297
3298 void Element::updateIdForTreeScope(TreeScope& scope, const AtomicString& oldId, const AtomicString& newId, NotifyObservers notifyObservers)
3299 {
3300     ASSERT(isInTreeScope());
3301     ASSERT(oldId != newId);
3302
3303     if (!oldId.isEmpty())
3304         scope.removeElementById(*oldId.impl(), *this, notifyObservers == NotifyObservers::Yes);
3305     if (!newId.isEmpty())
3306         scope.addElementById(*newId.impl(), *this, notifyObservers == NotifyObservers::Yes);
3307 }
3308
3309 void Element::updateIdForDocument(HTMLDocument& document, const AtomicString& oldId, const AtomicString& newId, HTMLDocumentNamedItemMapsUpdatingCondition condition)
3310 {
3311     ASSERT(isConnected());
3312     ASSERT(oldId != newId);
3313
3314     if (isInShadowTree())
3315         return;
3316
3317     if (WindowNameCollection::elementMatchesIfIdAttributeMatch(*this)) {
3318         const AtomicString& name = condition == UpdateHTMLDocumentNamedItemMapsOnlyIfDiffersFromNameAttribute && WindowNameCollection::elementMatchesIfNameAttributeMatch(*this) ? getNameAttribute() : nullAtom();
3319         if (!oldId.isEmpty() && oldId != name)
3320             document.removeWindowNamedItem(*oldId.impl(), *this);
3321         if (!newId.isEmpty() && newId != name)
3322             document.addWindowNamedItem(*newId.impl(), *this);
3323     }
3324
3325     if (DocumentNameCollection::elementMatchesIfIdAttributeMatch(*this)) {
3326         const AtomicString& name = condition == UpdateHTMLDocumentNamedItemMapsOnlyIfDiffersFromNameAttribute && DocumentNameCollection::elementMatchesIfNameAttributeMatch(*this) ? getNameAttribute() : nullAtom();
3327         if (!oldId.isEmpty() && oldId != name)
3328             document.removeDocumentNamedItem(*oldId.impl(), *this);
3329         if (!newId.isEmpty() && newId != name)
3330             document.addDocumentNamedItem(*newId.impl(), *this);
3331     }
3332 }
3333
3334 void Element::updateLabel(TreeScope& scope, const AtomicString& oldForAttributeValue, const AtomicString& newForAttributeValue)
3335 {
3336     ASSERT(hasTagName(labelTag));
3337
3338     if (!isConnected())
3339         return;
3340
3341     if (oldForAttributeValue == newForAttributeValue)
3342         return;
3343
3344     if (!oldForAttributeValue.isEmpty())
3345         scope.removeLabel(*oldForAttributeValue.impl(), downcast<HTMLLabelElement>(*this));
3346     if (!newForAttributeValue.isEmpty())
3347         scope.addLabel(*newForAttributeValue.impl(), downcast<HTMLLabelElement>(*this));
3348 }
3349
3350 void Element::willModifyAttribute(const QualifiedName& name, const AtomicString& oldValue, const AtomicString& newValue)
3351 {
3352     if (name == HTMLNames::idAttr)
3353         updateId(oldValue, newValue, NotifyObservers::No); // Will notify observers after the attribute is actually changed.
3354     else if (name == HTMLNames::nameAttr)
3355         updateName(oldValue, newValue);
3356     else if (name == HTMLNames::forAttr && hasTagName(labelTag)) {
3357         if (treeScope().shouldCacheLabelsByForAttribute())
3358             updateLabel(treeScope(), oldValue, newValue);
3359     }
3360
3361     if (auto recipients = MutationObserverInterestGroup::createForAttributesMutation(*this, name))
3362         recipients->enqueueMutationRecord(MutationRecord::createAttributes(*this, name, oldValue));
3363
3364     InspectorInstrumentation::willModifyDOMAttr(document(), *this, oldValue, newValue);
3365 }
3366
3367 void Element::didAddAttribute(const QualifiedName& name, const AtomicString& value)
3368 {
3369     attributeChanged(name, nullAtom(), value);
3370     InspectorInstrumentation::didModifyDOMAttr(document(), *this, name.localName(), value);
3371     dispatchSubtreeModifiedEvent();
3372 }
3373
3374 void Element::didModifyAttribute(const QualifiedName& name, const AtomicString& oldValue, const AtomicString& newValue)
3375 {
3376     attributeChanged(name, oldValue, newValue);
3377     InspectorInstrumentation::didModifyDOMAttr(document(), *this, name.localName(), newValue);
3378     // Do not dispatch a DOMSubtreeModified event here; see bug 81141.
3379 }
3380
3381 void Element::didRemoveAttribute(const QualifiedName& name, const AtomicString& oldValue)
3382 {
3383     attributeChanged(name, oldValue, nullAtom());
3384     InspectorInstrumentation::didRemoveDOMAttr(document(), *this, name.localName());
3385     dispatchSubtreeModifiedEvent();
3386 }
3387
3388 IntPoint Element::savedLayerScrollPosition() const
3389 {
3390     return hasRareData() ? elementRareData()->savedLayerScrollPosition() : IntPoint();
3391 }
3392
3393 void Element::setSavedLayerScrollPosition(const IntPoint& position)
3394 {
3395     if (position.isZero() && !hasRareData())
3396         return;
3397     ensureElementRareData().setSavedLayerScrollPosition(position);
3398 }
3399
3400 RefPtr<Attr> Element::attrIfExists(const AtomicString& localName, bool shouldIgnoreAttributeCase)
3401 {
3402     if (auto* attrNodeList = attrNodeListForElement(*this))
3403         return findAttrNodeInList(*attrNodeList, localName, shouldIgnoreAttributeCase);
3404     return nullptr;
3405 }
3406
3407 RefPtr<Attr> Element::attrIfExists(const QualifiedName& name)
3408 {
3409     if (auto* attrNodeList = attrNodeListForElement(*this))
3410         return findAttrNodeInList(*attrNodeList, name);
3411     return nullptr;
3412 }
3413
3414 Ref<Attr> Element::ensureAttr(const QualifiedName& name)
3415 {
3416     auto& attrNodeList = ensureAttrNodeListForElement(*this);
3417     RefPtr<Attr> attrNode = findAttrNodeInList(attrNodeList, name);
3418     if (!attrNode) {
3419         attrNode = Attr::create(*this, name);
3420         attrNode->setTreeScopeRecursively(treeScope());
3421         attrNodeList.append(attrNode);
3422     }
3423     return attrNode.releaseNonNull();
3424 }
3425
3426 void Element::detachAttrNodeFromElementWithValue(Attr* attrNode, const AtomicString& value)
3427 {
3428     ASSERT(hasSyntheticAttrChildNodes());
3429     attrNode->detachFromElementWithValue(value);
3430
3431     auto& attrNodeList = *attrNodeListForElement(*this);
3432     bool found = attrNodeList.removeFirstMatching([attrNode](auto& attribute) {
3433         return attribute->qualifiedName() == attrNode->qualifiedName();
3434     });
3435     ASSERT_UNUSED(found, found);
3436     if (attrNodeList.isEmpty())
3437         removeAttrNodeListForElement(*this);
3438 }
3439
3440 void Element::detachAllAttrNodesFromElement()
3441 {
3442     auto* attrNodeList = attrNodeListForElement(*this);
3443     ASSERT(attrNodeList);
3444
3445     for (const Attribute& attribute : attributesIterator()) {
3446         if (RefPtr<Attr> attrNode = findAttrNodeInList(*attrNodeList, attribute.name()))
3447             attrNode->detachFromElementWithValue(attribute.value());
3448     }
3449
3450     removeAttrNodeListForElement(*this);
3451 }
3452
3453 void Element::resetComputedStyle()
3454 {
3455     if (!hasRareData() || !elementRareData()->computedStyle())
3456         return;
3457
3458     auto reset = [](Element& element) {
3459         if (!element.hasRareData() || !element.elementRareData()->computedStyle())
3460             return;
3461         if (element.hasCustomStyleResolveCallbacks())
3462             element.willResetComputedStyle();
3463         element.elementRareData()->resetComputedStyle();
3464     };
3465     reset(*this);
3466     for (auto& child : descendantsOfType<Element>(*this))
3467         reset(child);
3468 }
3469
3470 void Element::resetStyleRelations()
3471 {
3472     if (!hasRareData())
3473         return;
3474     elementRareData()->resetStyleRelations();
3475 }
3476
3477 void Element::clearStyleDerivedDataBeforeDetachingRenderer()
3478 {
3479     unregisterNamedFlowContentElement();
3480     cancelFocusAppearanceUpdate();
3481     clearBeforePseudoElement();
3482     clearAfterPseudoElement();
3483 }
3484
3485 void Element::clearHoverAndActiveStatusBeforeDetachingRenderer()
3486 {
3487     if (!isUserActionElement())
3488         return;
3489     if (hovered())
3490         document().hoveredElementDidDetach(this);
3491     if (inActiveChain())
3492         document().elementInActiveChainDidDetach(this);
3493     document().userActionElements().didDetach(this);
3494 }
3495
3496 void Element::willRecalcStyle(Style::Change)
3497 {
3498     ASSERT(hasCustomStyleResolveCallbacks());
3499 }
3500
3501 void Element::didRecalcStyle(Style::Change)
3502 {
3503     ASSERT(hasCustomStyleResolveCallbacks());
3504 }
3505
3506 void Element::willResetComputedStyle()
3507 {
3508     ASSERT(hasCustomStyleResolveCallbacks());
3509 }
3510
3511 void Element::willAttachRenderers()
3512 {
3513     ASSERT(hasCustomStyleResolveCallbacks());
3514 }
3515
3516 void Element::didAttachRenderers()
3517 {
3518     ASSERT(hasCustomStyleResolveCallbacks());
3519 }
3520
3521 void Element::willDetachRenderers()
3522 {
3523     ASSERT(hasCustomStyleResolveCallbacks());
3524 }
3525
3526 void Element::didDetachRenderers()
3527 {
3528     ASSERT(hasCustomStyleResolveCallbacks());
3529 }
3530
3531 std::optional<ElementStyle> Element::resolveCustomStyle(const RenderStyle&, const RenderStyle*)
3532 {
3533     ASSERT(hasCustomStyleResolveCallbacks());
3534     return std::nullopt;
3535 }
3536
3537 void Element::cloneAttributesFromElement(const Element& other)
3538 {
3539     if (hasSyntheticAttrChildNodes())
3540         detachAllAttrNodesFromElement();
3541
3542     other.synchronizeAllAttributes();
3543     if (!other.m_elementData) {
3544         m_elementData = nullptr;
3545         return;
3546     }
3547
3548     // We can't update window and document's named item maps since the presence of image and object elements depend on other attributes and children.
3549     // Fortunately, those named item maps are only updated when this element is in the document, which should never be the case.
3550     ASSERT(!isConnected());
3551
3552     const AtomicString& oldID = getIdAttribute();
3553     const AtomicString& newID = other.getIdAttribute();
3554
3555     if (!oldID.isNull() || !newID.isNull())
3556         updateId(oldID, newID, NotifyObservers::No); // Will notify observers after the attribute is actually changed.
3557
3558     const AtomicString& oldName = getNameAttribute();
3559     const AtomicString& newName = other.getNameAttribute();
3560
3561     if (!oldName.isNull() || !newName.isNull())
3562         updateName(oldName, newName);
3563
3564     // If 'other' has a mutable ElementData, convert it to an immutable one so we can share it between both elements.
3565     // We can only do this if there is no CSSOM wrapper for other's inline style, and there are no presentation attributes.
3566     if (is<UniqueElementData>(*other.m_elementData)
3567         && !other.m_elementData->presentationAttributeStyle()
3568         && (!other.m_elementData->inlineStyle() || !other.m_elementData->inlineStyle()->hasCSSOMWrapper()))
3569         const_cast<Element&>(other).m_elementData = downcast<UniqueElementData>(*other.m_elementData).makeShareableCopy();
3570
3571     if (!other.m_elementData->isUnique())
3572         m_elementData = other.m_elementData;
3573     else
3574         m_elementData = other.m_elementData->makeUniqueCopy();
3575
3576     for (const Attribute& attribute : attributesIterator())
3577         attributeChanged(attribute.name(), nullAtom(), attribute.value(), ModifiedByCloning);
3578 }
3579
3580 void Element::cloneDataFromElement(const Element& other)
3581 {
3582     cloneAttributesFromElement(other);
3583     copyNonAttributePropertiesFromElement(other);
3584 }
3585
3586 void Element::createUniqueElementData()
3587 {
3588     if (!m_elementData)
3589         m_elementData = UniqueElementData::create();
3590     else
3591         m_elementData = downcast<ShareableElementData>(*m_elementData).makeUniqueCopy();
3592 }
3593
3594 bool Element::hasPendingResources() const
3595 {
3596     return hasRareData() && elementRareData()->hasPendingResources();
3597 }
3598
3599 void Element::setHasPendingResources()
3600 {
3601     ensureElementRareData().setHasPendingResources(true);
3602 }
3603
3604 void Element::clearHasPendingResources()
3605 {
3606     ensureElementRareData().setHasPendingResources(false);
3607 }
3608
3609 bool Element::canContainRangeEndPoint() const
3610 {
3611     return !equalLettersIgnoringASCIICase(attributeWithoutSynchronization(roleAttr), "img");
3612 }
3613
3614 String Element::completeURLsInAttributeValue(const URL& base, const Attribute& attribute) const
3615 {
3616     return URL(base, attribute.value()).string();
3617 }
3618
3619 ExceptionOr<Node*> Element::insertAdjacent(const String& where, Ref<Node>&& newChild)
3620 {
3621     // In Internet Explorer if the element has no parent and where is "beforeBegin" or "afterEnd",
3622     // a document fragment is created and the elements appended in the correct order. This document
3623     // fragment isn't returned anywhere.
3624     //
3625     // This is impossible for us to implement as the DOM tree does not allow for such structures,
3626     // Opera also appears to disallow such usage.
3627
3628     if (equalLettersIgnoringASCIICase(where, "beforebegin")) {
3629         auto* parent = this->parentNode();
3630         if (!parent)
3631             return nullptr;
3632         auto result = parent->insertBefore(newChild, this);
3633         if (result.hasException())
3634             return result.releaseException();
3635         return newChild.ptr();
3636     }
3637
3638     if (equalLettersIgnoringASCIICase(where, "afterbegin")) {
3639         auto result = insertBefore(newChild, firstChild());
3640         if (result.hasException())
3641             return result.releaseException();
3642         return newChild.ptr();
3643     }
3644
3645     if (equalLettersIgnoringASCIICase(where, "beforeend")) {
3646         auto result = appendChild(newChild);
3647         if (result.hasException())
3648             return result.releaseException();
3649         return newChild.ptr();
3650     }
3651
3652     if (equalLettersIgnoringASCIICase(where, "afterend")) {
3653         auto* parent = this->parentNode();
3654         if (!parent)
3655             return nullptr;
3656         auto result = parent->insertBefore(newChild, nextSibling());
3657         if (result.hasException())
3658             return result.releaseException();
3659         return newChild.ptr();
3660     }
3661
3662     return Exception { SYNTAX_ERR };
3663 }
3664
3665 ExceptionOr<Element*> Element::insertAdjacentElement(const String& where, Element& newChild)
3666 {
3667     auto result = insertAdjacent(where, newChild);
3668     if (result.hasException())
3669         return result.releaseException();
3670     return downcast<Element>(result.releaseReturnValue());
3671 }
3672
3673 // Step 1 of https://w3c.github.io/DOM-Parsing/#dom-element-insertadjacenthtml.
3674 static ExceptionOr<ContainerNode&> contextNodeForInsertion(const String& where, Element& element)
3675 {
3676     if (equalLettersIgnoringASCIICase(where, "beforebegin") || equalLettersIgnoringASCIICase(where, "afterend")) {
3677         auto* parent = element.parentNode();
3678         if (!parent || is<Document>(*parent))
3679             return Exception { NO_MODIFICATION_ALLOWED_ERR };
3680         return *parent;
3681     }
3682     if (equalLettersIgnoringASCIICase(where, "afterbegin") || equalLettersIgnoringASCIICase(where, "beforeend"))
3683         return element;
3684     return Exception { SYNTAX_ERR };
3685 }
3686
3687 // Step 2 of https://w3c.github.io/DOM-Parsing/#dom-element-insertadjacenthtml.
3688 static ExceptionOr<Ref<Element>> contextElementForInsertion(const String& where, Element& el