ladybird/Libraries/LibWeb/HTML/HTMLOptionElement.h
Feng Yu 89d50befb0 LibWeb: Sync <select> options handling with latest spec changes
- Rename HTMLOptionElement's `owner_select_element()` to
  `nearest_select_element()` to better match spec terminology.
- Update HTMLSelectElement's option list related algorithms.

This change is part of the customizable <select> spec work.
See whatwg/html#10548.
2025-12-12 12:06:24 +00:00

82 lines
2.7 KiB
C++

/*
* 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; }
private:
friend class Bindings::OptionConstructor;
friend class HTMLSelectElement;
HTMLOptionElement(DOM::Document&, DOM::QualifiedName);
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;
};
}