ladybird/Libraries/LibWeb/HTML/ElementInternals.h
Shannon Booth 637fd51595 LibWeb: Unify WebIDL C++ type generation
Represent WebIDL C++ types with a single CppType model that tracks
nullability, optional presence, and contained storage.

GC-like values now use GC::Ref/GC::Ptr directly, while containers choose
"plain", "Root", or "Conservative" container types depending on what
they contain. For example, sequence<Element> becomes a RootVector of
GC::Ref values, while sequence<SomeDictionary> becomes a
ConservativeVector only when the dictionary contains GC-like values.
This moves the generated bindings away from wrapping GC values in
GC::Root by default.

This has broad fallout as the types passed to interfaces for GC
objects changes almost fully across the board.
2026-05-23 18:26:12 +02:00

55 lines
1.9 KiB
C++

/*
* Copyright (c) 2024, the Ladybird developers.
*
* SPDX-License-Identifier: BSD-2-Clause
*/
#pragma once
#include <AK/WeakPtr.h>
#include <LibGC/Ptr.h>
#include <LibWeb/Bindings/PlatformObject.h>
#include <LibWeb/DOM/NodeList.h>
#include <LibWeb/Forward.h>
#include <LibWeb/HTML/HTMLElement.h>
#include <LibWeb/HTML/HTMLFormElement.h>
#include <LibWeb/HTML/ValidityState.h>
namespace Web::HTML {
// https://html.spec.whatwg.org/multipage/custom-elements.html#elementinternals
class ElementInternals final : public Bindings::PlatformObject {
WEB_PLATFORM_OBJECT(ElementInternals, Bindings::PlatformObject);
GC_DECLARE_ALLOCATOR(ElementInternals);
public:
static GC::Ref<ElementInternals> create(JS::Realm&, HTMLElement& target_element);
GC::Ptr<DOM::ShadowRoot> shadow_root() const;
using ElementInternalsFormValue = Variant<GC::Ref<FileAPI::File>, String, GC::Ref<XHR::FormData>, Empty>;
WebIDL::ExceptionOr<void> set_form_value(ElementInternalsFormValue value, Optional<ElementInternalsFormValue> state);
WebIDL::ExceptionOr<GC::Ptr<HTMLFormElement>> form() const;
WebIDL::ExceptionOr<void> set_validity(Bindings::ValidityStateFlags const& flags, Optional<String> message, GC::Ptr<HTMLElement> anchor);
WebIDL::ExceptionOr<bool> will_validate() const;
WebIDL::ExceptionOr<GC::Ref<ValidityState const>> validity() const;
WebIDL::ExceptionOr<String> validation_message() const;
WebIDL::ExceptionOr<bool> check_validity() const;
WebIDL::ExceptionOr<bool> report_validity() const;
WebIDL::ExceptionOr<GC::Ptr<DOM::NodeList>> labels();
GC::Ptr<CustomStateSet> states();
private:
explicit ElementInternals(JS::Realm&, HTMLElement& target_element);
virtual void initialize(JS::Realm&) override;
virtual void visit_edges(JS::Cell::Visitor& visitor) override;
// https://html.spec.whatwg.org/multipage/custom-elements.html#internals-target
GC::Ref<HTMLElement> m_target_element;
};
}