/* * Copyright (c) 2018-2021, 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 namespace Web::DOM { // https://w3c.github.io/csswg-drafts/cssom-view-1/#dictdef-scrolloptions struct ScrollOptions { Bindings::ScrollBehavior behavior { Bindings::ScrollBehavior::Auto }; }; // https://w3c.github.io/csswg-drafts/cssom-view-1/#dictdef-scrollintoviewoptions struct ScrollIntoViewOptions : public ScrollOptions { Bindings::ScrollLogicalPosition block { Bindings::ScrollLogicalPosition::Start }; Bindings::ScrollLogicalPosition inline_ { Bindings::ScrollLogicalPosition::Nearest }; }; class Element : public ParentNode , public ChildNode , public NonDocumentTypeChildNode { 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 FlyString node_name() const final { return html_uppercased_qualified_name(); } FlyString 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(); } FlyString const& prefix() const { return m_qualified_name.prefix(); } FlyString const& namespace_() const { return m_qualified_name.namespace_(); } // NOTE: This is for the JS bindings FlyString const& namespace_uri() const { return namespace_(); } bool has_attribute(FlyString const& name) const; bool has_attributes() const { return !m_attributes->is_empty(); } DeprecatedString attribute(FlyString const& name) const { return get_attribute(name); } DeprecatedString get_attribute(FlyString const& name) const; WebIDL::ExceptionOr set_attribute(FlyString const& name, DeprecatedString const& value); WebIDL::ExceptionOr set_attribute_ns(FlyString const& namespace_, FlyString const& qualified_name, DeprecatedString const& value); void remove_attribute(FlyString const& name); WebIDL::ExceptionOr toggle_attribute(FlyString 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(FlyString const& name) const; DOMTokenList* class_list(); 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(FlyString const& name, DeprecatedString const& value); virtual void did_remove_attribute(FlyString 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 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(FlyString const&); ShadowRoot* shadow_root() { return m_shadow_root.ptr(); } ShadowRoot const* shadow_root() 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> = {}); protected: Element(Document&, DOM::QualifiedName); virtual void 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(FlyString const& attribute_name); WebIDL::ExceptionOr> insert_adjacent(DeprecatedString const& where, JS::NonnullGCPtr node); 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; }; template<> inline bool Node::fast_is() const { return is_element(); } WebIDL::ExceptionOr validate_and_extract(JS::Realm&, FlyString namespace_, FlyString qualified_name); }