/* * Copyright (c) 2021, Andreas Kling * Copyright (c) 2024, Jelle Raaijmakers * * SPDX-License-Identifier: BSD-2-Clause */ #pragma once #include #include #include #include #include namespace Web::HTML { // Form-associated elements should invoke this macro to inject overridden FormAssociatedElement and HTMLElement // methods as needed. If your class wished to override an HTMLElement method that is overridden here, use the // following methods instead: // // HTMLElement::inserted() -> Use form_associated_element_was_inserted() // HTMLElement::removed_from() -> Use form_associated_element_was_removed() // #define FORM_ASSOCIATED_ELEMENT(ElementBaseClass, ElementClass) \ private: \ virtual HTMLElement& form_associated_element_to_html_element() override \ { \ static_assert(IsBaseOf); \ return *this; \ } \ \ virtual void inserted() override \ { \ ElementBaseClass::inserted(); \ form_node_was_inserted(); \ form_associated_element_was_inserted(); \ } \ \ virtual void removed_from(DOM::Node* node) override \ { \ ElementBaseClass::removed_from(node); \ form_node_was_removed(); \ form_associated_element_was_removed(node); \ } \ \ virtual void attribute_changed(FlyString const& name, Optional const& old_value, Optional const& value) override \ { \ ElementBaseClass::attribute_changed(name, old_value, value); \ form_node_attribute_changed(name, value); \ form_associated_element_attribute_changed(name, value); \ } // https://html.spec.whatwg.org/multipage/form-control-infrastructure.html#selection-direction enum class SelectionDirection { Forward, Backward, None, }; class FormAssociatedElement { public: HTMLFormElement* form() { return m_form; } HTMLFormElement const* form() const { return m_form; } void set_form(HTMLFormElement*); void element_id_changed(Badge); void element_with_id_was_added_or_removed(Badge); bool enabled() const; void set_parser_inserted(Badge); // https://html.spec.whatwg.org/multipage/forms.html#category-listed virtual bool is_listed() const { return false; } // https://html.spec.whatwg.org/multipage/forms.html#category-submit virtual bool is_submittable() const { return false; } // https://html.spec.whatwg.org/multipage/forms.html#category-reset virtual bool is_resettable() const { return false; } // https://html.spec.whatwg.org/multipage/forms.html#category-autocapitalize virtual bool is_auto_capitalize_inheriting() const { return false; } // https://html.spec.whatwg.org/multipage/forms.html#concept-button virtual bool is_button() const { return false; } // https://html.spec.whatwg.org/multipage/forms.html#concept-submit-button virtual bool is_submit_button() const { return false; } virtual String value() const { return String {}; } virtual HTMLElement& form_associated_element_to_html_element() = 0; HTMLElement const& form_associated_element_to_html_element() const { return const_cast(*this).form_associated_element_to_html_element(); } // https://html.spec.whatwg.org/multipage/form-control-infrastructure.html#concept-form-reset-control virtual void reset_algorithm() {}; virtual void clear_algorithm(); String form_action() const; WebIDL::ExceptionOr set_form_action(String const&); protected: FormAssociatedElement() = default; virtual ~FormAssociatedElement() = default; virtual void form_associated_element_was_inserted() { } virtual void form_associated_element_was_removed(DOM::Node*) { } virtual void form_associated_element_attribute_changed(FlyString const&, Optional const&) { } void form_node_was_inserted(); void form_node_was_removed(); void form_node_attribute_changed(FlyString const&, Optional const&); private: void reset_form_owner(); WeakPtr m_form; // https://html.spec.whatwg.org/multipage/form-control-infrastructure.html#parser-inserted-flag bool m_parser_inserted { false }; }; enum class SelectionSource { UI, DOM, }; class FormAssociatedTextControlElement : public FormAssociatedElement { public: // https://html.spec.whatwg.org/multipage/form-control-infrastructure.html#concept-textarea/input-relevant-value virtual String relevant_value() = 0; virtual WebIDL::ExceptionOr set_relevant_value(String const&) = 0; virtual void set_dirty_value_flag(bool flag) = 0; // https://html.spec.whatwg.org/multipage/form-control-infrastructure.html#dom-textarea/input-select WebIDL::ExceptionOr select(); // https://html.spec.whatwg.org/multipage/form-control-infrastructure.html#dom-textarea/input-selectionstart Optional selection_start() const; WebIDL::ExceptionOr set_selection_start(Optional const&); // https://html.spec.whatwg.org/multipage/form-control-infrastructure.html#dom-textarea/input-selectionend Optional selection_end() const; WebIDL::ExceptionOr set_selection_end(Optional const&); // https://html.spec.whatwg.org/multipage/form-control-infrastructure.html#dom-textarea/input-selectiondirection Optional selection_direction() const; void set_selection_direction(Optional direction); WebIDL::ExceptionOr set_selection_direction_binding(Optional direction); SelectionDirection selection_direction_state() const { return m_selection_direction; } // https://html.spec.whatwg.org/multipage/form-control-infrastructure.html#dom-textarea/input-setrangetext WebIDL::ExceptionOr set_range_text(String const& replacement); WebIDL::ExceptionOr set_range_text(String const& replacement, WebIDL::UnsignedLong start, WebIDL::UnsignedLong end, Bindings::SelectionMode = Bindings::SelectionMode::Preserve); // https://html.spec.whatwg.org/multipage/form-control-infrastructure.html#dom-textarea/input-setselectionrange void set_the_selection_range(Optional start, Optional end, SelectionDirection direction = SelectionDirection::None, SelectionSource source = SelectionSource::DOM); // https://html.spec.whatwg.org/multipage/form-control-infrastructure.html#dom-textarea/input-setselectionrange WebIDL::ExceptionOr set_selection_range(Optional start, Optional end, Optional direction); // https://w3c.github.io/selection-api/#dfn-has-scheduled-selectionchange-event bool has_scheduled_selectionchange_event() const { return m_has_scheduled_selectionchange_event; } void set_scheduled_selectionchange_event(bool value) { m_has_scheduled_selectionchange_event = value; } protected: // https://html.spec.whatwg.org/multipage/form-control-infrastructure.html#concept-textarea/input-relevant-value void relevant_value_was_changed(JS::GCPtr); virtual void selection_was_changed([[maybe_unused]] size_t selection_start, [[maybe_unused]] size_t selection_end) { } private: // https://html.spec.whatwg.org/multipage/form-control-infrastructure.html#concept-textarea/input-selection WebIDL::UnsignedLong m_selection_start { 0 }; WebIDL::UnsignedLong m_selection_end { 0 }; SelectionDirection m_selection_direction { SelectionDirection::None }; // https://w3c.github.io/selection-api/#dfn-has-scheduled-selectionchange-event bool m_has_scheduled_selectionchange_event { false }; }; }