ladybird/Libraries/LibWeb/DOM/ShadowRoot.h
Jelle Raaijmakers 00397b4808 LibWeb: Keep track of elements with an anchor-name set
We maintain a registry of elements with an anchor-name so once they are
referenced for anchor positioning, we can find them with an O(1) lookup
instead of traversing the entire DOM tree.
2026-04-01 19:41:46 +01:00

216 lines
8.5 KiB
C++
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

/*
* Copyright (c) 2020, the SerenityOS developers.
*
* SPDX-License-Identifier: BSD-2-Clause
*/
#pragma once
#include <LibWeb/Bindings/ShadowRootPrototype.h>
#include <LibWeb/CSS/StyleScope.h>
#include <LibWeb/DOM/AnchorNameMap.h>
#include <LibWeb/DOM/DocumentFragment.h>
#include <LibWeb/DOM/ElementByIdMap.h>
#include <LibWeb/DOM/SlotRegistry.h>
#include <LibWeb/Export.h>
#include <LibWeb/WebIDL/ObservableArray.h>
namespace Web::DOM {
class WEB_API ShadowRoot final : public DocumentFragment {
WEB_PLATFORM_OBJECT(ShadowRoot, DocumentFragment);
GC_DECLARE_ALLOCATOR(ShadowRoot);
public:
static constexpr bool OVERRIDES_FINALIZE = true;
Bindings::ShadowRootMode mode() const { return m_mode; }
Bindings::SlotAssignmentMode slot_assignment() const { return m_slot_assignment; }
void set_slot_assignment(Bindings::SlotAssignmentMode slot_assignment) { m_slot_assignment = slot_assignment; }
bool delegates_focus() const { return m_delegates_focus; }
void set_delegates_focus(bool delegates_focus) { m_delegates_focus = delegates_focus; }
[[nodiscard]] bool declarative() const { return m_declarative; }
void set_declarative(bool declarative) { m_declarative = declarative; }
[[nodiscard]] bool clonable() const { return m_clonable; }
void set_clonable(bool clonable) { m_clonable = clonable; }
[[nodiscard]] bool serializable() const { return m_serializable; }
void set_serializable(bool serializable) { m_serializable = serializable; }
void set_onslotchange(WebIDL::CallbackType*);
WebIDL::CallbackType* onslotchange();
bool available_to_element_internals() const { return m_available_to_element_internals; }
void set_available_to_element_internals(bool available_to_element_internals) { m_available_to_element_internals = available_to_element_internals; }
[[nodiscard]] bool is_user_agent_internal() const { return m_user_agent_internal; }
void set_user_agent_internal(bool user_agent_internal) { m_user_agent_internal = user_agent_internal; }
[[nodiscard]] bool uses_document_style_sheets() const { return m_uses_document_style_sheets; }
void set_uses_document_style_sheets(bool value) { m_uses_document_style_sheets = value; }
// ^EventTarget
virtual EventTarget* get_parent(Event const&) override;
WebIDL::ExceptionOr<TrustedTypes::TrustedHTMLOrString> inner_html() const;
WebIDL::ExceptionOr<void> set_inner_html(TrustedTypes::TrustedHTMLOrString const&);
WebIDL::ExceptionOr<void> set_html_unsafe(TrustedTypes::TrustedHTMLOrString const&);
WebIDL::ExceptionOr<String> get_html(GetHTMLOptions const&) const;
GC::Ptr<Element> active_element();
CSS::StyleSheetList& style_sheets();
CSS::StyleSheetList const& style_sheets() const;
CSS::StyleSheetList* style_sheets_for_bindings() { return &style_sheets(); }
GC::Ref<WebIDL::ObservableArray> adopted_style_sheets() const;
WebIDL::ExceptionOr<void> set_adopted_style_sheets(JS::Value);
void for_each_css_style_sheet(Function<void(CSS::CSSStyleSheet&)>&& callback) const;
void for_each_active_css_style_sheet(Function<void(CSS::CSSStyleSheet&)> const& callback) const;
WebIDL::ExceptionOr<Vector<GC::Ref<Animations::Animation>>> get_animations();
ElementByIdMap& element_by_id() const;
AnchorNameMap& anchor_name_map() { return m_anchor_name_map; }
AnchorNameMap const& anchor_name_map() const { return m_anchor_name_map; }
void register_slot(HTML::HTMLSlotElement&);
void unregister_slot(HTML::HTMLSlotElement&);
template<typename Callback>
void for_each_registered_slot(Callback callback)
{
if (m_slot_registry)
m_slot_registry->for_each_slot(callback);
}
GC::Ptr<HTML::HTMLSlotElement> first_slot_with_name(FlyString const& name) const;
CSS::StyleScope const& style_scope() const { return m_style_scope; }
CSS::StyleScope& style_scope() { return m_style_scope; }
using PartElementMap = HashMap<FlyString, OrderedHashTable<AbstractElement>>;
PartElementMap const& part_element_map() const;
GC::Ptr<HTML::CustomElementRegistry> custom_element_registry() const;
void set_custom_element_registry(GC::Ptr<HTML::CustomElementRegistry> registry) { m_custom_element_registry = registry; }
bool keep_custom_element_registry_null() const { return m_keep_custom_element_registry_null; }
void set_keep_custom_element_registry_null(bool value) { m_keep_custom_element_registry_null = value; }
virtual void finalize() override;
GC::Ptr<Element> fullscreen_element_for_bindings() const;
protected:
virtual void visit_edges(Cell::Visitor&) override;
private:
ShadowRoot(Document&, Element& host, Bindings::ShadowRootMode);
virtual void initialize(JS::Realm&) override;
// ^Node
virtual FlyString node_name() const override { return "#shadow-root"_fly_string; }
virtual bool is_shadow_root() const final { return true; }
void calculate_part_element_map();
// NOTE: The specification doesn't seem to specify a default value for mode. Assuming closed for now.
Bindings::ShadowRootMode m_mode { Bindings::ShadowRootMode::Closed };
Bindings::SlotAssignmentMode m_slot_assignment { Bindings::SlotAssignmentMode::Named };
bool m_delegates_focus { false };
bool m_available_to_element_internals { false };
bool m_user_agent_internal { false };
bool m_uses_document_style_sheets { false };
// https://dom.spec.whatwg.org/#shadowroot-declarative
bool m_declarative { false };
// https://dom.spec.whatwg.org/#shadowroot-clonable
bool m_clonable { false };
// https://dom.spec.whatwg.org/#shadowroot-serializable
bool m_serializable { false };
mutable OwnPtr<ElementByIdMap> m_element_by_id;
AnchorNameMap m_anchor_name_map;
OwnPtr<SlotRegistry> m_slot_registry;
GC::Ptr<CSS::StyleSheetList> m_style_sheets;
mutable GC::Ptr<WebIDL::ObservableArray> m_adopted_style_sheets;
IntrusiveListNode<ShadowRoot> m_list_node;
CSS::StyleScope m_style_scope;
mutable PartElementMap m_part_element_map;
mutable u64 m_dom_tree_version_when_calculated_part_element_map { 0 };
// https://dom.spec.whatwg.org/#shadowroot-custom-element-registry
GC::Ptr<HTML::CustomElementRegistry> m_custom_element_registry;
// https://dom.spec.whatwg.org/#shadowroot-keep-custom-element-registry-null
bool m_keep_custom_element_registry_null { false };
public:
using DocumentShadowRootList = IntrusiveList<&ShadowRoot::m_list_node>;
};
template<>
inline bool Node::fast_is<ShadowRoot>() const { return node_type() == to_underlying(NodeType::DOCUMENT_FRAGMENT_NODE) && is_shadow_root(); }
// https://dom.spec.whatwg.org/#concept-shadow-including-tree-order
// In shadow-including tree order is shadow-including preorder, depth-first traversal of a node tree.
// Shadow-including preorder, depth-first traversal of a node tree tree is preorder, depth-first traversal
// of tree, with for each shadow host encountered in tree, shadow-including preorder, depth-first traversal
// of that elements shadow roots node tree just after it is encountered.
// https://dom.spec.whatwg.org/#concept-shadow-including-descendant
// An object A is a shadow-including descendant of an object B, if A is a descendant of B, or As root is a
// shadow root and As roots host is a shadow-including inclusive descendant of B.
// https://dom.spec.whatwg.org/#concept-shadow-including-inclusive-descendant
// A shadow-including inclusive descendant is an object or one of its shadow-including descendants.
template<typename Callback>
inline TraversalDecision Node::for_each_shadow_including_inclusive_descendant(Callback callback)
{
if (callback(*this) == TraversalDecision::Break)
return TraversalDecision::Break;
if (this->for_each_shadow_including_descendant(callback) == TraversalDecision::Break)
return TraversalDecision::Break;
return TraversalDecision::Continue;
}
template<typename Callback>
inline TraversalDecision Node::for_each_shadow_including_descendant(Callback callback)
{
if (is_element()) {
if (auto shadow_root = static_cast<Element*>(this)->shadow_root()) {
if (shadow_root->for_each_shadow_including_inclusive_descendant(callback) == TraversalDecision::Break)
return TraversalDecision::Break;
}
}
for (auto* child = first_child(); child; child = child->next_sibling()) {
if (child->for_each_shadow_including_inclusive_descendant(callback) == TraversalDecision::Break)
return TraversalDecision::Break;
}
return TraversalDecision::Continue;
}
}