/* * Copyright (c) 2020, the SerenityOS developers. * Copyright (c) 2022, Luke Wilde * * SPDX-License-Identifier: BSD-2-Clause */ #pragma once #include namespace Web::DOM { class Range final : public AbstractRange { public: using WrapperType = Bindings::RangeWrapper; virtual ~Range() override; static NonnullRefPtr create(Document&); static NonnullRefPtr create(HTML::Window&); static NonnullRefPtr create(Node& start_container, u32 start_offset, Node& end_container, u32 end_offset); static NonnullRefPtr create_with_global_object(Bindings::WindowObject&); // FIXME: There are a ton of methods missing here. ExceptionOr set_start(Node& node, u32 offset); ExceptionOr set_end(Node& node, u32 offset); ExceptionOr set_start_before(Node& node); ExceptionOr set_start_after(Node& node); ExceptionOr set_end_before(Node& node); ExceptionOr set_end_after(Node& node); ExceptionOr select_node(Node& node); void collapse(bool to_start); ExceptionOr select_node_contents(Node const&); // https://dom.spec.whatwg.org/#dom-range-start_to_start enum HowToCompareBoundaryPoints : u16 { START_TO_START = 0, START_TO_END = 1, END_TO_END = 2, END_TO_START = 3, }; ExceptionOr compare_boundary_points(u16 how, Range const& source_range) const; NonnullRefPtr inverted() const; NonnullRefPtr normalized() const; NonnullRefPtr clone_range() const; NonnullRefPtr common_ancestor_container() const; // https://dom.spec.whatwg.org/#dom-range-detach void detach() const { // The detach() method steps are to do nothing. // Note: Its functionality (disabling a Range object) was removed, but the method itself is preserved for compatibility. } bool intersects_node(Node const&) const; ExceptionOr is_point_in_range(Node const&, u32 offset) const; ExceptionOr compare_point(Node const&, u32 offset) const; ExceptionOr delete_contents(); ExceptionOr> extract_contents(); ExceptionOr> clone_contents(); ExceptionOr insert_node(NonnullRefPtr); ExceptionOr surround_contents(NonnullRefPtr new_parent); String to_string() const; static HashTable& live_ranges(); private: explicit Range(Document&); Range(Node& start_container, u32 start_offset, Node& end_container, u32 end_offset); Node& root(); Node const& root() const; enum class StartOrEnd { Start, End, }; ExceptionOr set_start_or_end(Node& node, u32 offset, StartOrEnd start_or_end); ExceptionOr select(Node& node); ExceptionOr> extract(); ExceptionOr> clone_the_contents(); ExceptionOr insert(NonnullRefPtr); bool contains_node(Node const&) const; bool partially_contains_node(Node const&) const; }; }