Element.h 24 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542
  1. /*
  2. * Copyright (c) 2018-2024, Andreas Kling <andreas@ladybird.org>
  3. *
  4. * SPDX-License-Identifier: BSD-2-Clause
  5. */
  6. #pragma once
  7. #include <AK/Optional.h>
  8. #include <LibWeb/ARIA/ARIAMixin.h>
  9. #include <LibWeb/Animations/Animatable.h>
  10. #include <LibWeb/Bindings/ElementPrototype.h>
  11. #include <LibWeb/Bindings/Intrinsics.h>
  12. #include <LibWeb/Bindings/ShadowRootPrototype.h>
  13. #include <LibWeb/CSS/CountersSet.h>
  14. #include <LibWeb/CSS/Selector.h>
  15. #include <LibWeb/CSS/StyleInvalidation.h>
  16. #include <LibWeb/CSS/StyleProperties.h>
  17. #include <LibWeb/CSS/StyleProperty.h>
  18. #include <LibWeb/DOM/ChildNode.h>
  19. #include <LibWeb/DOM/NonDocumentTypeChildNode.h>
  20. #include <LibWeb/DOM/ParentNode.h>
  21. #include <LibWeb/DOM/QualifiedName.h>
  22. #include <LibWeb/DOM/Slottable.h>
  23. #include <LibWeb/HTML/AttributeNames.h>
  24. #include <LibWeb/HTML/EventLoop/Task.h>
  25. #include <LibWeb/HTML/LazyLoadingElement.h>
  26. #include <LibWeb/HTML/ScrollOptions.h>
  27. #include <LibWeb/HTML/TagNames.h>
  28. #include <LibWeb/IntersectionObserver/IntersectionObserver.h>
  29. #include <LibWeb/WebIDL/ExceptionOr.h>
  30. namespace Web::DOM {
  31. struct ShadowRootInit {
  32. Bindings::ShadowRootMode mode;
  33. bool delegates_focus = false;
  34. Bindings::SlotAssignmentMode slot_assignment { Bindings::SlotAssignmentMode::Named };
  35. bool clonable = false;
  36. bool serializable = false;
  37. };
  38. struct GetHTMLOptions {
  39. bool serializable_shadow_roots { false };
  40. Vector<JS::Handle<ShadowRoot>> shadow_roots {};
  41. };
  42. // https://w3c.github.io/csswg-drafts/cssom-view-1/#dictdef-scrollintoviewoptions
  43. struct ScrollIntoViewOptions : public HTML::ScrollOptions {
  44. Bindings::ScrollLogicalPosition block { Bindings::ScrollLogicalPosition::Start };
  45. Bindings::ScrollLogicalPosition inline_ { Bindings::ScrollLogicalPosition::Nearest };
  46. };
  47. // https://drafts.csswg.org/cssom-view-1/#dictdef-checkvisibilityoptions
  48. struct CheckVisibilityOptions {
  49. bool check_opacity = false;
  50. bool check_visibility_css = false;
  51. bool content_visibility_auto = false;
  52. bool opacity_property = false;
  53. bool visibility_property = false;
  54. };
  55. // https://html.spec.whatwg.org/multipage/custom-elements.html#upgrade-reaction
  56. // An upgrade reaction, which will upgrade the custom element and contains a custom element definition; or
  57. struct CustomElementUpgradeReaction {
  58. JS::Handle<HTML::CustomElementDefinition> custom_element_definition;
  59. };
  60. // https://html.spec.whatwg.org/multipage/custom-elements.html#callback-reaction
  61. // A callback reaction, which will call a lifecycle callback, and contains a callback function as well as a list of arguments.
  62. struct CustomElementCallbackReaction {
  63. JS::Handle<WebIDL::CallbackType> callback;
  64. JS::MarkedVector<JS::Value> arguments;
  65. };
  66. // https://dom.spec.whatwg.org/#concept-element-custom-element-state
  67. // An element’s custom element state is one of "undefined", "failed", "uncustomized", "precustomized", or "custom".
  68. enum class CustomElementState {
  69. Undefined,
  70. Failed,
  71. Uncustomized,
  72. Precustomized,
  73. Custom,
  74. };
  75. class Element
  76. : public ParentNode
  77. , public ChildNode<Element>
  78. , public NonDocumentTypeChildNode<Element>
  79. , public SlottableMixin
  80. , public ARIA::ARIAMixin
  81. , public Animations::Animatable {
  82. WEB_PLATFORM_OBJECT(Element, ParentNode);
  83. public:
  84. virtual ~Element() override;
  85. FlyString const& qualified_name() const { return m_qualified_name.as_string(); }
  86. FlyString const& html_uppercased_qualified_name() const { return m_html_uppercased_qualified_name; }
  87. virtual FlyString node_name() const final { return html_uppercased_qualified_name(); }
  88. FlyString const& local_name() const { return m_qualified_name.local_name(); }
  89. // NOTE: This is for the JS bindings
  90. FlyString const& tag_name() const { return html_uppercased_qualified_name(); }
  91. Optional<FlyString> const& prefix() const { return m_qualified_name.prefix(); }
  92. void set_prefix(Optional<FlyString> value);
  93. Optional<String> locate_a_namespace_prefix(Optional<String> const& namespace_) const;
  94. // NOTE: This is for the JS bindings
  95. Optional<FlyString> const& namespace_uri() const { return m_qualified_name.namespace_(); }
  96. bool has_attribute(FlyString const& name) const;
  97. bool has_attribute_ns(Optional<FlyString> const& namespace_, FlyString const& name) const;
  98. bool has_attributes() const;
  99. Optional<String> attribute(FlyString const& name) const { return get_attribute(name); }
  100. Optional<String> get_attribute(FlyString const& name) const;
  101. Optional<String> get_attribute_ns(Optional<FlyString> const& namespace_, FlyString const& name) const;
  102. String get_attribute_value(FlyString const& local_name, Optional<FlyString> const& namespace_ = {}) const;
  103. WebIDL::ExceptionOr<void> set_attribute(FlyString const& name, String const& value);
  104. WebIDL::ExceptionOr<void> set_attribute_ns(Optional<FlyString> const& namespace_, FlyString const& qualified_name, String const& value);
  105. void set_attribute_value(FlyString const& local_name, String const& value, Optional<FlyString> const& prefix = {}, Optional<FlyString> const& namespace_ = {});
  106. WebIDL::ExceptionOr<JS::GCPtr<Attr>> set_attribute_node(Attr&);
  107. WebIDL::ExceptionOr<JS::GCPtr<Attr>> set_attribute_node_ns(Attr&);
  108. void append_attribute(FlyString const& name, String const& value);
  109. void append_attribute(Attr&);
  110. void remove_attribute(FlyString const& name);
  111. void remove_attribute_ns(Optional<FlyString> const& namespace_, FlyString const& name);
  112. WebIDL::ExceptionOr<JS::NonnullGCPtr<Attr>> remove_attribute_node(JS::NonnullGCPtr<Attr>);
  113. WebIDL::ExceptionOr<bool> toggle_attribute(FlyString const& name, Optional<bool> force);
  114. size_t attribute_list_size() const;
  115. NamedNodeMap const* attributes() const { return m_attributes.ptr(); }
  116. Vector<String> get_attribute_names() const;
  117. JS::GCPtr<Attr> get_attribute_node(FlyString const& name) const;
  118. JS::GCPtr<Attr> get_attribute_node_ns(Optional<FlyString> const& namespace_, FlyString const& name) const;
  119. DOMTokenList* class_list();
  120. WebIDL::ExceptionOr<JS::NonnullGCPtr<ShadowRoot>> attach_shadow(ShadowRootInit init);
  121. WebIDL::ExceptionOr<void> attach_a_shadow_root(Bindings::ShadowRootMode mode, bool clonable, bool serializable, bool delegates_focus, Bindings::SlotAssignmentMode slot_assignment);
  122. JS::GCPtr<ShadowRoot> shadow_root_for_bindings() const;
  123. WebIDL::ExceptionOr<bool> matches(StringView selectors) const;
  124. WebIDL::ExceptionOr<DOM::Element const*> closest(StringView selectors) const;
  125. int client_top() const;
  126. int client_left() const;
  127. int client_width() const;
  128. int client_height() const;
  129. [[nodiscard]] double current_css_zoom() const;
  130. void for_each_attribute(Function<void(Attr const&)>) const;
  131. void for_each_attribute(Function<void(FlyString const&, String const&)>) const;
  132. bool has_class(FlyString const&, CaseSensitivity = CaseSensitivity::CaseSensitive) const;
  133. Vector<FlyString> const& class_names() const { return m_classes; }
  134. // https://html.spec.whatwg.org/multipage/embedded-content-other.html#dimension-attributes
  135. virtual bool supports_dimension_attributes() const { return false; }
  136. virtual void apply_presentational_hints(CSS::StyleProperties&) const { }
  137. // https://dom.spec.whatwg.org/#concept-element-attributes-change-ext
  138. virtual void attribute_change_steps(FlyString const& local_name, Optional<String> const& old_value, Optional<String> const& value, Optional<FlyString> const& namespace_);
  139. void run_attribute_change_steps(FlyString const& local_name, Optional<String> const& old_value, Optional<String> const& value, Optional<FlyString> const& namespace_);
  140. virtual void attribute_changed(FlyString const& name, Optional<String> const& old_value, Optional<String> const& value);
  141. CSS::RequiredInvalidationAfterStyleChange recompute_style();
  142. Optional<CSS::Selector::PseudoElement::Type> use_pseudo_element() const { return m_use_pseudo_element; }
  143. void set_use_pseudo_element(Optional<CSS::Selector::PseudoElement::Type> use_pseudo_element) { m_use_pseudo_element = move(use_pseudo_element); }
  144. JS::GCPtr<Layout::NodeWithStyle> layout_node();
  145. JS::GCPtr<Layout::NodeWithStyle const> layout_node() const;
  146. Optional<CSS::StyleProperties>& computed_css_values() { return m_computed_css_values; }
  147. Optional<CSS::StyleProperties> const& computed_css_values() const { return m_computed_css_values; }
  148. void set_computed_css_values(Optional<CSS::StyleProperties>);
  149. CSS::StyleProperties resolved_css_values(Optional<CSS::Selector::PseudoElement::Type> = {});
  150. void set_pseudo_element_computed_css_values(CSS::Selector::PseudoElement::Type, Optional<CSS::StyleProperties>);
  151. Optional<CSS::StyleProperties&> pseudo_element_computed_css_values(CSS::Selector::PseudoElement::Type);
  152. void reset_animated_css_properties();
  153. JS::GCPtr<CSS::ElementInlineCSSStyleDeclaration const> inline_style() const { return m_inline_style; }
  154. CSS::CSSStyleDeclaration* style_for_bindings();
  155. CSS::StyleSheetList& document_or_shadow_root_style_sheets();
  156. WebIDL::ExceptionOr<JS::NonnullGCPtr<DOM::DocumentFragment>> parse_fragment(StringView markup);
  157. WebIDL::ExceptionOr<String> inner_html() const;
  158. WebIDL::ExceptionOr<void> set_inner_html(StringView);
  159. WebIDL::ExceptionOr<void> set_html_unsafe(StringView);
  160. WebIDL::ExceptionOr<String> get_html(GetHTMLOptions const&) const;
  161. WebIDL::ExceptionOr<void> insert_adjacent_html(String const& position, String const&);
  162. WebIDL::ExceptionOr<String> outer_html() const;
  163. WebIDL::ExceptionOr<void> set_outer_html(String const&);
  164. bool is_focused() const;
  165. bool is_active() const;
  166. bool is_target() const;
  167. bool is_document_element() const;
  168. bool is_shadow_host() const;
  169. JS::GCPtr<ShadowRoot> shadow_root() { return m_shadow_root; }
  170. JS::GCPtr<ShadowRoot const> shadow_root() const { return m_shadow_root; }
  171. void set_shadow_root(JS::GCPtr<ShadowRoot>);
  172. void set_custom_properties(Optional<CSS::Selector::PseudoElement::Type>, HashMap<FlyString, CSS::StyleProperty> custom_properties);
  173. [[nodiscard]] HashMap<FlyString, CSS::StyleProperty> const& custom_properties(Optional<CSS::Selector::PseudoElement::Type>) const;
  174. // NOTE: The function is wrapped in a JS::HeapFunction immediately.
  175. HTML::TaskID queue_an_element_task(HTML::Task::Source, Function<void()>);
  176. bool is_void_element() const;
  177. bool serializes_as_void() const;
  178. JS::NonnullGCPtr<Geometry::DOMRect> get_bounding_client_rect() const;
  179. JS::NonnullGCPtr<Geometry::DOMRectList> get_client_rects() const;
  180. virtual JS::GCPtr<Layout::Node> create_layout_node(CSS::StyleProperties);
  181. virtual void adjust_computed_style(CSS::StyleProperties&) { }
  182. virtual void did_receive_focus() { }
  183. virtual void did_lose_focus() { }
  184. static JS::GCPtr<Layout::NodeWithStyle> create_layout_node_for_display_type(DOM::Document&, CSS::Display const&, CSS::StyleProperties, Element*);
  185. void set_pseudo_element_node(Badge<Layout::TreeBuilder>, CSS::Selector::PseudoElement::Type, JS::GCPtr<Layout::NodeWithStyle>);
  186. JS::GCPtr<Layout::NodeWithStyle> get_pseudo_element_node(CSS::Selector::PseudoElement::Type) const;
  187. bool has_pseudo_elements() const;
  188. void clear_pseudo_element_nodes(Badge<Layout::TreeBuilder>);
  189. void serialize_pseudo_elements_as_json(JsonArraySerializer<StringBuilder>& children_array) const;
  190. i32 tab_index() const;
  191. void set_tab_index(i32 tab_index);
  192. bool is_potentially_scrollable() const;
  193. double scroll_top() const;
  194. double scroll_left() const;
  195. void set_scroll_top(double y);
  196. void set_scroll_left(double x);
  197. int scroll_width() const;
  198. int scroll_height() const;
  199. bool is_actually_disabled() const;
  200. WebIDL::ExceptionOr<JS::GCPtr<Element>> insert_adjacent_element(String const& where, JS::NonnullGCPtr<Element> element);
  201. WebIDL::ExceptionOr<void> insert_adjacent_text(String const& where, String const& data);
  202. // https://w3c.github.io/csswg-drafts/cssom-view-1/#dom-element-scrollintoview
  203. ErrorOr<void> scroll_into_view(Optional<Variant<bool, ScrollIntoViewOptions>> = {});
  204. // https://www.w3.org/TR/wai-aria-1.2/#ARIAMixin
  205. #define ARIA_IMPL(name, attribute) \
  206. Optional<String> name() const override \
  207. { \
  208. return get_attribute(attribute); \
  209. } \
  210. \
  211. WebIDL::ExceptionOr<void> set_##name(Optional<String> const& value) override \
  212. { \
  213. if (value.has_value()) \
  214. TRY(set_attribute(attribute, *value)); \
  215. else \
  216. remove_attribute(attribute); \
  217. return {}; \
  218. }
  219. // https://www.w3.org/TR/wai-aria-1.2/#accessibilityroleandproperties-correspondence
  220. ARIA_IMPL(role, "role"_fly_string);
  221. ARIA_IMPL(aria_active_descendant, "aria-activedescendant"_fly_string);
  222. ARIA_IMPL(aria_atomic, "aria-atomic"_fly_string);
  223. ARIA_IMPL(aria_auto_complete, "aria-autocomplete"_fly_string);
  224. ARIA_IMPL(aria_braille_label, "aria-braillelabel"_fly_string);
  225. ARIA_IMPL(aria_braille_role_description, "aria-brailleroledescription"_fly_string);
  226. ARIA_IMPL(aria_busy, "aria-busy"_fly_string);
  227. ARIA_IMPL(aria_checked, "aria-checked"_fly_string);
  228. ARIA_IMPL(aria_col_count, "aria-colcount"_fly_string);
  229. ARIA_IMPL(aria_col_index, "aria-colindex"_fly_string);
  230. ARIA_IMPL(aria_col_index_text, "aria-colindextext"_fly_string);
  231. ARIA_IMPL(aria_col_span, "aria-colspan"_fly_string);
  232. ARIA_IMPL(aria_controls, "aria-controls"_fly_string);
  233. ARIA_IMPL(aria_current, "aria-current"_fly_string);
  234. ARIA_IMPL(aria_described_by, "aria-describedby"_fly_string);
  235. ARIA_IMPL(aria_description, "aria-description"_fly_string);
  236. ARIA_IMPL(aria_details, "aria-details"_fly_string);
  237. ARIA_IMPL(aria_drop_effect, "aria-dropeffect"_fly_string);
  238. ARIA_IMPL(aria_error_message, "aria-errormessage"_fly_string);
  239. ARIA_IMPL(aria_disabled, "aria-disabled"_fly_string);
  240. ARIA_IMPL(aria_expanded, "aria-expanded"_fly_string);
  241. ARIA_IMPL(aria_flow_to, "aria-flowto"_fly_string);
  242. ARIA_IMPL(aria_grabbed, "aria-grabbed"_fly_string);
  243. ARIA_IMPL(aria_has_popup, "aria-haspopup"_fly_string);
  244. ARIA_IMPL(aria_hidden, "aria-hidden"_fly_string);
  245. ARIA_IMPL(aria_invalid, "aria-invalid"_fly_string);
  246. ARIA_IMPL(aria_key_shortcuts, "aria-keyshortcuts"_fly_string);
  247. ARIA_IMPL(aria_label, "aria-label"_fly_string);
  248. ARIA_IMPL(aria_labelled_by, "aria-labelledby"_fly_string);
  249. ARIA_IMPL(aria_level, "aria-level"_fly_string);
  250. ARIA_IMPL(aria_live, "aria-live"_fly_string);
  251. ARIA_IMPL(aria_modal, "aria-modal"_fly_string);
  252. ARIA_IMPL(aria_multi_line, "aria-multiline"_fly_string);
  253. ARIA_IMPL(aria_multi_selectable, "aria-multiselectable"_fly_string);
  254. ARIA_IMPL(aria_orientation, "aria-orientation"_fly_string);
  255. ARIA_IMPL(aria_owns, "aria-owns"_fly_string);
  256. ARIA_IMPL(aria_placeholder, "aria-placeholder"_fly_string);
  257. ARIA_IMPL(aria_pos_in_set, "aria-posinset"_fly_string);
  258. ARIA_IMPL(aria_pressed, "aria-pressed"_fly_string);
  259. ARIA_IMPL(aria_read_only, "aria-readonly"_fly_string);
  260. ARIA_IMPL(aria_relevant, "aria-relevant"_fly_string);
  261. ARIA_IMPL(aria_required, "aria-required"_fly_string);
  262. ARIA_IMPL(aria_role_description, "aria-roledescription"_fly_string);
  263. ARIA_IMPL(aria_row_count, "aria-rowcount"_fly_string);
  264. ARIA_IMPL(aria_row_index, "aria-rowindex"_fly_string);
  265. ARIA_IMPL(aria_row_index_text, "aria-rowindextext"_fly_string);
  266. ARIA_IMPL(aria_row_span, "aria-rowspan"_fly_string);
  267. ARIA_IMPL(aria_selected, "aria-selected"_fly_string);
  268. ARIA_IMPL(aria_set_size, "aria-setsize"_fly_string);
  269. ARIA_IMPL(aria_sort, "aria-sort"_fly_string);
  270. ARIA_IMPL(aria_value_max, "aria-valuemax"_fly_string);
  271. ARIA_IMPL(aria_value_min, "aria-valuemin"_fly_string);
  272. ARIA_IMPL(aria_value_now, "aria-valuenow"_fly_string);
  273. ARIA_IMPL(aria_value_text, "aria-valuetext"_fly_string);
  274. #undef ARIA_IMPL
  275. virtual bool exclude_from_accessibility_tree() const override;
  276. virtual bool include_in_accessibility_tree() const override;
  277. void enqueue_a_custom_element_upgrade_reaction(HTML::CustomElementDefinition& custom_element_definition);
  278. void enqueue_a_custom_element_callback_reaction(FlyString const& callback_name, JS::MarkedVector<JS::Value> arguments);
  279. using CustomElementReactionQueue = Vector<Variant<CustomElementUpgradeReaction, CustomElementCallbackReaction>>;
  280. CustomElementReactionQueue* custom_element_reaction_queue() { return m_custom_element_reaction_queue; }
  281. CustomElementReactionQueue const* custom_element_reaction_queue() const { return m_custom_element_reaction_queue; }
  282. CustomElementReactionQueue& ensure_custom_element_reaction_queue();
  283. JS::ThrowCompletionOr<void> upgrade_element(JS::NonnullGCPtr<HTML::CustomElementDefinition> custom_element_definition);
  284. void try_to_upgrade();
  285. bool is_defined() const;
  286. bool is_custom() const;
  287. Optional<String> const& is_value() const { return m_is_value; }
  288. void set_is_value(Optional<String> const& is) { m_is_value = is; }
  289. void set_custom_element_state(CustomElementState value) { m_custom_element_state = value; }
  290. void setup_custom_element_from_constructor(HTML::CustomElementDefinition& custom_element_definition, Optional<String> const& is_value);
  291. void scroll(HTML::ScrollToOptions);
  292. void scroll(double x, double y);
  293. void scroll_by(HTML::ScrollToOptions);
  294. void scroll_by(double x, double y);
  295. bool check_visibility(Optional<CheckVisibilityOptions>);
  296. void register_intersection_observer(Badge<IntersectionObserver::IntersectionObserver>, IntersectionObserver::IntersectionObserverRegistration);
  297. void unregister_intersection_observer(Badge<IntersectionObserver::IntersectionObserver>, JS::NonnullGCPtr<IntersectionObserver::IntersectionObserver>);
  298. IntersectionObserver::IntersectionObserverRegistration& get_intersection_observer_registration(Badge<DOM::Document>, IntersectionObserver::IntersectionObserver const&);
  299. enum class ScrollOffsetFor {
  300. Self,
  301. PseudoBefore,
  302. PseudoAfter
  303. };
  304. CSSPixelPoint scroll_offset(ScrollOffsetFor type) const { return m_scroll_offset[to_underlying(type)]; }
  305. void set_scroll_offset(ScrollOffsetFor type, CSSPixelPoint offset) { m_scroll_offset[to_underlying(type)] = offset; }
  306. enum class Dir {
  307. Ltr,
  308. Rtl,
  309. Auto,
  310. };
  311. Optional<Dir> dir() const { return m_dir; }
  312. enum class Directionality {
  313. Ltr,
  314. Rtl,
  315. };
  316. Directionality directionality() const;
  317. Optional<FlyString> const& id() const { return m_id; }
  318. Optional<FlyString> const& name() const { return m_name; }
  319. virtual JS::GCPtr<JS::HeapFunction<void()>> take_lazy_load_resumption_steps(Badge<DOM::Document>)
  320. {
  321. return nullptr;
  322. }
  323. void set_in_top_layer(bool in_top_layer) { m_in_top_layer = in_top_layer; }
  324. bool in_top_layer() const { return m_in_top_layer; }
  325. bool has_non_empty_counters_set() const { return m_counters_set; }
  326. Optional<CSS::CountersSet const&> counters_set();
  327. CSS::CountersSet& ensure_counters_set();
  328. void resolve_counters(CSS::StyleProperties&);
  329. void inherit_counters();
  330. protected:
  331. Element(Document&, DOM::QualifiedName);
  332. virtual void initialize(JS::Realm&) override;
  333. virtual void inserted() override;
  334. virtual void removed_from(Node*) override;
  335. virtual void children_changed() override;
  336. virtual i32 default_tab_index_value() const;
  337. virtual void computed_css_values_changed() { }
  338. virtual void visit_edges(Cell::Visitor&) override;
  339. virtual bool id_reference_exists(String const&) const override;
  340. CustomElementState custom_element_state() const { return m_custom_element_state; }
  341. private:
  342. void make_html_uppercased_qualified_name();
  343. void invalidate_style_after_attribute_change(FlyString const& attribute_name);
  344. WebIDL::ExceptionOr<JS::GCPtr<Node>> insert_adjacent(StringView where, JS::NonnullGCPtr<Node> node);
  345. void enqueue_an_element_on_the_appropriate_element_queue();
  346. Optional<Directionality> auto_directionality() const;
  347. Optional<Directionality> contained_text_auto_directionality(bool can_exclude_root) const;
  348. Directionality parent_directionality() const;
  349. bool is_auto_directionality_form_associated_element() const;
  350. QualifiedName m_qualified_name;
  351. FlyString m_html_uppercased_qualified_name;
  352. JS::GCPtr<NamedNodeMap> m_attributes;
  353. JS::GCPtr<CSS::ElementInlineCSSStyleDeclaration> m_inline_style;
  354. JS::GCPtr<DOMTokenList> m_class_list;
  355. JS::GCPtr<ShadowRoot> m_shadow_root;
  356. Optional<CSS::StyleProperties> m_computed_css_values;
  357. HashMap<FlyString, CSS::StyleProperty> m_custom_properties;
  358. struct PseudoElement {
  359. JS::GCPtr<Layout::NodeWithStyle> layout_node;
  360. Optional<CSS::StyleProperties> computed_css_values;
  361. HashMap<FlyString, CSS::StyleProperty> custom_properties;
  362. };
  363. // TODO: CSS::Selector::PseudoElement::Type includes a lot of pseudo-elements that exist in shadow trees,
  364. // and so we don't want to include data for them here.
  365. using PseudoElementData = Array<PseudoElement, to_underlying(CSS::Selector::PseudoElement::Type::KnownPseudoElementCount)>;
  366. mutable OwnPtr<PseudoElementData> m_pseudo_element_data;
  367. Optional<PseudoElement&> get_pseudo_element(CSS::Selector::PseudoElement::Type) const;
  368. PseudoElement& ensure_pseudo_element(CSS::Selector::PseudoElement::Type) const;
  369. Optional<CSS::Selector::PseudoElement::Type> m_use_pseudo_element;
  370. Vector<FlyString> m_classes;
  371. Optional<Dir> m_dir;
  372. Optional<FlyString> m_id;
  373. Optional<FlyString> m_name;
  374. // https://html.spec.whatwg.org/multipage/custom-elements.html#custom-element-reaction-queue
  375. // All elements have an associated custom element reaction queue, initially empty. Each item in the custom element reaction queue is of one of two types:
  376. // NOTE: See the structs at the top of this header.
  377. OwnPtr<CustomElementReactionQueue> m_custom_element_reaction_queue;
  378. // https://dom.spec.whatwg.org/#concept-element-custom-element-state
  379. CustomElementState m_custom_element_state { CustomElementState::Undefined };
  380. // https://dom.spec.whatwg.org/#concept-element-custom-element-definition
  381. JS::GCPtr<HTML::CustomElementDefinition> m_custom_element_definition;
  382. // https://dom.spec.whatwg.org/#concept-element-is-value
  383. Optional<String> m_is_value;
  384. // https://www.w3.org/TR/intersection-observer/#dom-element-registeredintersectionobservers-slot
  385. // Element objects have an internal [[RegisteredIntersectionObservers]] slot, which is initialized to an empty list.
  386. OwnPtr<Vector<IntersectionObserver::IntersectionObserverRegistration>> m_registered_intersection_observers;
  387. Array<CSSPixelPoint, 3> m_scroll_offset;
  388. bool m_in_top_layer { false };
  389. OwnPtr<CSS::CountersSet> m_counters_set;
  390. };
  391. template<>
  392. inline bool Node::fast_is<Element>() const { return is_element(); }
  393. inline Element* Node::parent_element()
  394. {
  395. auto* parent = this->parent();
  396. if (!parent || !is<Element>(parent))
  397. return nullptr;
  398. return static_cast<Element*>(parent);
  399. }
  400. inline Element const* Node::parent_element() const
  401. {
  402. auto const* parent = this->parent();
  403. if (!parent || !is<Element>(parent))
  404. return nullptr;
  405. return static_cast<Element const*>(parent);
  406. }
  407. inline bool Element::has_class(FlyString const& class_name, CaseSensitivity case_sensitivity) const
  408. {
  409. if (case_sensitivity == CaseSensitivity::CaseSensitive) {
  410. return any_of(m_classes, [&](auto& it) {
  411. return it == class_name;
  412. });
  413. }
  414. return any_of(m_classes, [&](auto& it) {
  415. return it.equals_ignoring_ascii_case(class_name);
  416. });
  417. }
  418. WebIDL::ExceptionOr<QualifiedName> validate_and_extract(JS::Realm&, Optional<FlyString> namespace_, FlyString const& qualified_name);
  419. }