ladybird/Libraries/LibWeb/HTML/HTMLOptionElement.h

/*
 * Copyright (c) 2020, the SerenityOS developers.
 * Copyright (c) 2022, Andreas Kling <andreas@ladybird.org>
 *
 * SPDX-License-Identifier: BSD-2-Clause
 */

#pragma once

#include <LibWeb/Export.h>
#include <LibWeb/HTML/HTMLElement.h>

namespace Web::HTML {

class WEB_API HTMLOptionElement final : public HTMLElement {
    WEB_PLATFORM_OBJECT(HTMLOptionElement, HTMLElement);
    GC_DECLARE_ALLOCATOR(HTMLOptionElement);

public:
    virtual ~HTMLOptionElement() override;

    bool selected() const { return m_selected; }
    void set_selected(bool);
    void set_selected_internal(bool);
    [[nodiscard]] u64 selectedness_update_index() const { return m_selectedness_update_index; }

    Utf16String value() const;
    void set_value(Utf16String const&);

    Utf16String text() const;
    void set_text(Utf16String const&);

    [[nodiscard]] String label() const;
    void set_label(String const&);

    int index() const;

    bool disabled() const;

    GC::Ptr<HTML::HTMLFormElement const> form() const;

    virtual Optional<ARIA::Role> default_role() const override;

    GC::Ptr<HTMLSelectElement> nearest_select_element() { return m_cached_nearest_select_element; }
    GC::Ptr<HTMLSelectElement const> nearest_select_element() const { return m_cached_nearest_select_element; }

    // https://html.spec.whatwg.org/multipage/form-elements.html#the-option-element:clone-an-option-into-a-selectedcontent
    WebIDL::ExceptionOr<void> maybe_clone_into_selectedcontent();
    // https://html.spec.whatwg.org/multipage/form-elements.html#clone-an-option-into-a-selectedcontent
    WebIDL::ExceptionOr<void> clone_into_selectedcontent(GC::Ref<HTMLSelectedContentElement>);

private:
    friend class Bindings::OptionConstructor;
    friend class HTMLSelectElement;

    HTMLOptionElement(DOM::Document&, DOM::QualifiedName);

    virtual bool is_html_option_element() const final { return true; }

    virtual void initialize(JS::Realm&) override;
    virtual void visit_edges(Cell::Visitor&) override;

    virtual void attribute_changed(FlyString const& name, Optional<String> const& old_value, Optional<String> const& value, Optional<FlyString> const& namespace_) override;

    virtual void inserted() override;
    virtual void removed_from(Node* old_parent, Node& old_root) override;
    virtual void children_changed(ChildrenChangedMetadata const*) override;

    void ask_for_a_reset();
    void update_selection_label();

    // https://html.spec.whatwg.org/multipage/form-elements.html#update-an-option's-nearest-ancestor-select
    void update_nearest_select_element();
    // https://html.spec.whatwg.org/multipage/form-elements.html#option-element-nearest-ancestor-select
    GC::Ptr<HTMLSelectElement> compute_nearest_select_element();

    // https://html.spec.whatwg.org/multipage/form-elements.html#concept-option-selectedness
    bool m_selected { false };

    // https://html.spec.whatwg.org/multipage/form-elements.html#concept-option-dirtiness
    bool m_dirty { false };

    u64 m_selectedness_update_index { 0 };

    // https://html.spec.whatwg.org/multipage/form-elements.html#cached-nearest-ancestor-select-element
    GC::Ptr<HTMLSelectElement> m_cached_nearest_select_element;
};

}

namespace Web::DOM {

template<>
inline bool Node::fast_is<HTML::HTMLOptionElement>() const { return is_html_option_element(); }

}