/* * Copyright (c) 2018-2023, Andreas Kling * * SPDX-License-Identifier: BSD-2-Clause */ #pragma once #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include namespace Web::DOM { struct ShadowRootInit { Bindings::ShadowRootMode mode; bool delegates_focus = false; }; // https://w3c.github.io/csswg-drafts/cssom-view-1/#dictdef-scrollintoviewoptions struct ScrollIntoViewOptions : public HTML::ScrollOptions { Bindings::ScrollLogicalPosition block { Bindings::ScrollLogicalPosition::Start }; Bindings::ScrollLogicalPosition inline_ { Bindings::ScrollLogicalPosition::Nearest }; }; // https://html.spec.whatwg.org/multipage/custom-elements.html#upgrade-reaction // An upgrade reaction, which will upgrade the custom element and contains a custom element definition; or struct CustomElementUpgradeReaction { JS::Handle custom_element_definition; }; // https://html.spec.whatwg.org/multipage/custom-elements.html#callback-reaction // A callback reaction, which will call a lifecycle callback, and contains a callback function as well as a list of arguments. struct CustomElementCallbackReaction { JS::Handle callback; JS::MarkedVector arguments; }; // https://dom.spec.whatwg.org/#concept-element-custom-element-state // An element’s custom element state is one of "undefined", "failed", "uncustomized", "precustomized", or "custom". enum class CustomElementState { Undefined, Failed, Uncustomized, Precustomized, Custom, }; class Element : public ParentNode , public ChildNode , public NonDocumentTypeChildNode , public ARIA::ARIAMixin { WEB_PLATFORM_OBJECT(Element, ParentNode); public: virtual ~Element() override; DeprecatedString const& qualified_name() const { return m_qualified_name.as_string(); } DeprecatedString const& html_uppercased_qualified_name() const { return m_html_uppercased_qualified_name; } virtual DeprecatedFlyString node_name() const final { return html_uppercased_qualified_name(); } DeprecatedFlyString const& local_name() const { return m_qualified_name.local_name(); } // NOTE: This is for the JS bindings DeprecatedString const& tag_name() const { return html_uppercased_qualified_name(); } DeprecatedFlyString const& prefix() const { return m_qualified_name.prefix(); } void set_prefix(DeprecatedFlyString const& value); DeprecatedFlyString const& namespace_() const { return m_qualified_name.namespace_(); } // NOTE: This is for the JS bindings DeprecatedFlyString const& namespace_uri() const { return namespace_(); } bool has_attribute(DeprecatedFlyString const& name) const; bool has_attributes() const { return !m_attributes->is_empty(); } DeprecatedString attribute(DeprecatedFlyString const& name) const { return get_attribute(name); } DeprecatedString get_attribute(DeprecatedFlyString const& name) const; WebIDL::ExceptionOr set_attribute(DeprecatedFlyString const& name, DeprecatedString const& value); WebIDL::ExceptionOr set_attribute_ns(DeprecatedFlyString const& namespace_, DeprecatedFlyString const& qualified_name, DeprecatedString const& value); WebIDL::ExceptionOr> set_attribute_node(Attr&); WebIDL::ExceptionOr> set_attribute_node_ns(Attr&); void remove_attribute(DeprecatedFlyString const& name); WebIDL::ExceptionOr toggle_attribute(DeprecatedFlyString const& name, Optional force); size_t attribute_list_size() const { return m_attributes->length(); } NamedNodeMap const* attributes() const { return m_attributes.ptr(); } Vector get_attribute_names() const; JS::GCPtr get_attribute_node(DeprecatedFlyString const& name) const; DOMTokenList* class_list(); WebIDL::ExceptionOr> attach_shadow(ShadowRootInit init); JS::GCPtr shadow_root() const; WebIDL::ExceptionOr matches(StringView selectors) const; WebIDL::ExceptionOr closest(StringView selectors) const; int client_top() const; int client_left() const; int client_width() const; int client_height() const; template void for_each_attribute(Callback callback) const { for (size_t i = 0; i < m_attributes->length(); ++i) { auto const* attribute = m_attributes->item(i); callback(attribute->name(), attribute->value()); } } bool has_class(FlyString const&, CaseSensitivity = CaseSensitivity::CaseSensitive) const; Vector const& class_names() const { return m_classes; } virtual void apply_presentational_hints(CSS::StyleProperties&) const { } virtual void parse_attribute(DeprecatedFlyString const& name, DeprecatedString const& value); virtual void did_remove_attribute(DeprecatedFlyString const&); enum class NeedsRelayout { No = 0, Yes = 1, }; NeedsRelayout recompute_style(); Layout::NodeWithStyle* layout_node() { return static_cast(Node::layout_node()); } Layout::NodeWithStyle const* layout_node() const { return static_cast(Node::layout_node()); } DeprecatedString name() const { return attribute(HTML::AttributeNames::name); } CSS::StyleProperties* computed_css_values() { return m_computed_css_values.ptr(); } CSS::StyleProperties const* computed_css_values() const { return m_computed_css_values.ptr(); } void set_computed_css_values(RefPtr style) { m_computed_css_values = move(style); } NonnullRefPtr resolved_css_values(); CSS::CSSStyleDeclaration const* inline_style() const; CSS::CSSStyleDeclaration* style_for_bindings(); WebIDL::ExceptionOr inner_html() const; WebIDL::ExceptionOr set_inner_html(DeprecatedString const&); WebIDL::ExceptionOr insert_adjacent_html(DeprecatedString position, DeprecatedString text); bool is_focused() const; bool is_active() const; JS::NonnullGCPtr get_elements_by_class_name(DeprecatedFlyString const&); bool is_shadow_host() const; ShadowRoot* shadow_root_internal() { return m_shadow_root.ptr(); } ShadowRoot const* shadow_root_internal() const { return m_shadow_root.ptr(); } void set_shadow_root(JS::GCPtr); void set_custom_properties(HashMap custom_properties) { m_custom_properties = move(custom_properties); } HashMap const& custom_properties() const { return m_custom_properties; } void queue_an_element_task(HTML::Task::Source, JS::SafeFunction); bool is_void_element() const; bool serializes_as_void() const; JS::NonnullGCPtr get_bounding_client_rect() const; JS::NonnullGCPtr get_client_rects() const; virtual JS::GCPtr create_layout_node(NonnullRefPtr); virtual void did_receive_focus() { } virtual void did_lose_focus() { } static JS::GCPtr create_layout_node_for_display_type(DOM::Document&, CSS::Display const&, NonnullRefPtr, Element*); void set_pseudo_element_node(Badge, CSS::Selector::PseudoElement, JS::GCPtr); JS::GCPtr get_pseudo_element_node(CSS::Selector::PseudoElement) const; void clear_pseudo_element_nodes(Badge); void serialize_pseudo_elements_as_json(JsonArraySerializer& children_array) const; i32 tab_index() const; void set_tab_index(i32 tab_index); bool is_potentially_scrollable() const; double scroll_top() const; double scroll_left() const; void set_scroll_top(double y); void set_scroll_left(double x); int scroll_width() const; int scroll_height() const; bool is_actually_disabled() const; WebIDL::ExceptionOr> insert_adjacent_element(DeprecatedString const& where, JS::NonnullGCPtr element); WebIDL::ExceptionOr insert_adjacent_text(DeprecatedString const& where, DeprecatedString const& data); // https://w3c.github.io/csswg-drafts/cssom-view-1/#dom-element-scrollintoview ErrorOr scroll_into_view(Optional> = {}); // https://www.w3.org/TR/wai-aria-1.2/#ARIAMixin #define ARIA_IMPL(name, attribute) \ DeprecatedString name() const override \ { \ return get_attribute(attribute); \ } \ \ WebIDL::ExceptionOr set_##name(DeprecatedString const& value) override \ { \ TRY(set_attribute(attribute, value)); \ return {}; \ } // https://www.w3.org/TR/wai-aria-1.2/#accessibilityroleandproperties-correspondence ARIA_IMPL(role, "role"); ARIA_IMPL(aria_active_descendant, "aria-activedescendant"); ARIA_IMPL(aria_atomic, "aria-atomic"); ARIA_IMPL(aria_auto_complete, "aria-autocomplete"); ARIA_IMPL(aria_busy, "aria-busy"); ARIA_IMPL(aria_checked, "aria-checked"); ARIA_IMPL(aria_col_count, "aria-colcount"); ARIA_IMPL(aria_col_index, "aria-colindex"); ARIA_IMPL(aria_col_span, "aria-colspan"); ARIA_IMPL(aria_controls, "aria-controls"); ARIA_IMPL(aria_current, "aria-current"); ARIA_IMPL(aria_described_by, "aria-describedby"); ARIA_IMPL(aria_details, "aria-details"); ARIA_IMPL(aria_drop_effect, "aria-dropeffect"); ARIA_IMPL(aria_error_message, "aria-errormessage"); ARIA_IMPL(aria_disabled, "aria-disabled"); ARIA_IMPL(aria_expanded, "aria-expanded"); ARIA_IMPL(aria_flow_to, "aria-flowto"); ARIA_IMPL(aria_grabbed, "aria-grabbed"); ARIA_IMPL(aria_has_popup, "aria-haspopup"); ARIA_IMPL(aria_hidden, "aria-hidden"); ARIA_IMPL(aria_invalid, "aria-invalid"); ARIA_IMPL(aria_key_shortcuts, "aria-keyshortcuts"); ARIA_IMPL(aria_label, "aria-label"); ARIA_IMPL(aria_labelled_by, "aria-labelledby"); ARIA_IMPL(aria_level, "aria-level"); ARIA_IMPL(aria_live, "aria-live"); ARIA_IMPL(aria_modal, "aria-modal"); ARIA_IMPL(aria_multi_line, "aria-multiline"); ARIA_IMPL(aria_multi_selectable, "aria-multiselectable"); ARIA_IMPL(aria_orientation, "aria-orientation"); ARIA_IMPL(aria_owns, "aria-owns"); ARIA_IMPL(aria_placeholder, "aria-placeholder"); ARIA_IMPL(aria_pos_in_set, "aria-posinset"); ARIA_IMPL(aria_pressed, "aria-pressed"); ARIA_IMPL(aria_read_only, "aria-readonly"); ARIA_IMPL(aria_relevant, "aria-relevant"); ARIA_IMPL(aria_required, "aria-required"); ARIA_IMPL(aria_role_description, "aria-roledescription"); ARIA_IMPL(aria_row_count, "aria-rowcount"); ARIA_IMPL(aria_row_index, "aria-rowindex"); ARIA_IMPL(aria_row_span, "aria-rowspan"); ARIA_IMPL(aria_selected, "aria-selected"); ARIA_IMPL(aria_set_size, "aria-setsize"); ARIA_IMPL(aria_sort, "aria-sort"); ARIA_IMPL(aria_value_max, "aria-valuemax"); ARIA_IMPL(aria_value_min, "aria-valuemin"); ARIA_IMPL(aria_value_now, "aria-valuenow"); ARIA_IMPL(aria_value_text, "aria-valuetext"); #undef ARIA_IMPL virtual bool exclude_from_accessibility_tree() const override; virtual bool include_in_accessibility_tree() const override; void enqueue_a_custom_element_upgrade_reaction(HTML::CustomElementDefinition& custom_element_definition); void enqueue_a_custom_element_callback_reaction(FlyString const& callback_name, JS::MarkedVector arguments); Vector>& custom_element_reaction_queue() { return m_custom_element_reaction_queue; } Vector> const& custom_element_reaction_queue() const { return m_custom_element_reaction_queue; } JS::ThrowCompletionOr upgrade_element(JS::NonnullGCPtr custom_element_definition); void try_to_upgrade(); bool is_defined() const; bool is_custom() const; Optional const& is_value() const { return m_is_value; } void set_is_value(Optional const& is) { m_is_value = is; } void set_custom_element_state(CustomElementState value) { m_custom_element_state = value; } void setup_custom_element_from_constructor(HTML::CustomElementDefinition& custom_element_definition, Optional const& is_value); protected: Element(Document&, DOM::QualifiedName); virtual JS::ThrowCompletionOr initialize(JS::Realm&) override; virtual void children_changed() override; virtual i32 default_tab_index_value() const; virtual void visit_edges(Cell::Visitor&) override; private: void make_html_uppercased_qualified_name(); void invalidate_style_after_attribute_change(DeprecatedFlyString const& attribute_name); WebIDL::ExceptionOr> insert_adjacent(DeprecatedString const& where, JS::NonnullGCPtr node); void enqueue_an_element_on_the_appropriate_element_queue(); QualifiedName m_qualified_name; DeprecatedString m_html_uppercased_qualified_name; JS::GCPtr m_attributes; JS::GCPtr m_inline_style; JS::GCPtr m_class_list; JS::GCPtr m_shadow_root; RefPtr m_computed_css_values; HashMap m_custom_properties; Vector m_classes; Array, to_underlying(CSS::Selector::PseudoElement::PseudoElementCount)> m_pseudo_element_nodes; // https://html.spec.whatwg.org/multipage/custom-elements.html#custom-element-reaction-queue // 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: // NOTE: See the structs at the top of this header. Vector> m_custom_element_reaction_queue; // https://dom.spec.whatwg.org/#concept-element-custom-element-state CustomElementState m_custom_element_state { CustomElementState::Undefined }; // https://dom.spec.whatwg.org/#concept-element-custom-element-definition JS::GCPtr m_custom_element_definition; // https://dom.spec.whatwg.org/#concept-element-is-value Optional m_is_value; }; template<> inline bool Node::fast_is() const { return is_element(); } WebIDL::ExceptionOr validate_and_extract(JS::Realm&, DeprecatedFlyString namespace_, DeprecatedFlyString qualified_name); }