mirror of
https://github.com/LadybirdBrowser/ladybird.git
synced 2025-07-13 20:41:53 +00:00
ac1c2a956a
Some checks are pending
CI / Lagom (arm64, Sanitizer_CI, false, macos-15, macOS, Clang) (push) Waiting to run
CI / Lagom (x86_64, Fuzzers_CI, false, ubuntu-24.04, Linux, Clang) (push) Waiting to run
CI / Lagom (x86_64, Sanitizer_CI, false, ubuntu-24.04, Linux, GNU) (push) Waiting to run
CI / Lagom (x86_64, Sanitizer_CI, true, ubuntu-24.04, Linux, Clang) (push) Waiting to run
Package the js repl as a binary artifact / build-and-package (arm64, macos-15, macOS, macOS-universal2) (push) Waiting to run
Package the js repl as a binary artifact / build-and-package (x86_64, ubuntu-24.04, Linux, Linux-x86_64) (push) Waiting to run
Run test262 and test-wasm / run_and_update_results (push) Waiting to run
Lint Code / lint (push) Waiting to run
Label PRs with merge conflicts / auto-labeler (push) Waiting to run
Push notes / build (push) Waiting to run
For attributes like Element.ariaControlsElements, which are a reflection of FrozenArray<Element>, we must return the same JS::Array object every time the attribute is invoked - until its contents have changed. This patch implements caching of the reflected array in accordance with the spec.
98 lines
3.6 KiB
C++
98 lines
3.6 KiB
C++
/*
|
|
* Copyright (c) 2022, Jonah Shafran <jonahshafran@gmail.com>
|
|
*
|
|
* SPDX-License-Identifier: BSD-2-Clause
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <AK/String.h>
|
|
#include <AK/Vector.h>
|
|
#include <LibWeb/ARIA/AriaData.h>
|
|
#include <LibWeb/ARIA/AttributeNames.h>
|
|
#include <LibWeb/ARIA/Roles.h>
|
|
#include <LibWeb/WebIDL/ExceptionOr.h>
|
|
|
|
namespace Web::ARIA {
|
|
|
|
#define ENUMERATE_ARIA_ELEMENT_REFERENCING_ATTRIBUTES \
|
|
__ENUMERATE_ARIA_ATTRIBUTE(aria_active_descendant_element, aria_active_descendant)
|
|
|
|
#define ENUMERATE_ARIA_ELEMENT_LIST_REFERENCING_ATTRIBUTES \
|
|
__ENUMERATE_ARIA_ATTRIBUTE(aria_controls_elements, aria_controls) \
|
|
__ENUMERATE_ARIA_ATTRIBUTE(aria_described_by_elements, aria_described_by) \
|
|
__ENUMERATE_ARIA_ATTRIBUTE(aria_details_elements, aria_details) \
|
|
__ENUMERATE_ARIA_ATTRIBUTE(aria_error_message_elements, aria_error_message) \
|
|
__ENUMERATE_ARIA_ATTRIBUTE(aria_flow_to_elements, aria_flow_to) \
|
|
__ENUMERATE_ARIA_ATTRIBUTE(aria_labelled_by_elements, aria_labelled_by) \
|
|
__ENUMERATE_ARIA_ATTRIBUTE(aria_owns_elements, aria_owns)
|
|
|
|
class ARIAMixin {
|
|
public:
|
|
virtual ~ARIAMixin();
|
|
|
|
#define __ENUMERATE_ARIA_ATTRIBUTE(name, attribute) \
|
|
virtual Optional<String> name() const = 0; \
|
|
virtual WebIDL::ExceptionOr<void> set_##name(Optional<String> const&) = 0;
|
|
ENUMERATE_ARIA_ATTRIBUTES
|
|
#undef __ENUMERATE_ARIA_ATTRIBUTE
|
|
|
|
// https://www.w3.org/TR/html-aria/#docconformance
|
|
virtual Optional<Role> default_role() const { return {}; }
|
|
|
|
virtual DOM::Element& to_element() = 0;
|
|
virtual DOM::Element const& to_element() const = 0;
|
|
|
|
Optional<Role> role_from_role_attribute_value() const;
|
|
Optional<Role> role_or_default() const;
|
|
|
|
// https://www.w3.org/TR/wai-aria-1.2/#tree_exclusion
|
|
virtual bool exclude_from_accessibility_tree() const = 0;
|
|
|
|
// https://www.w3.org/TR/wai-aria-1.2/#tree_inclusion
|
|
virtual bool include_in_accessibility_tree() const = 0;
|
|
|
|
bool has_global_aria_attribute() const;
|
|
|
|
// https://www.w3.org/TR/wai-aria-1.2/#valuetype_idref
|
|
Optional<String> parse_id_reference(Optional<String> const&) const;
|
|
|
|
// https://www.w3.org/TR/wai-aria-1.2/#valuetype_idref_list
|
|
Vector<String> parse_id_reference_list(Optional<String> const&) const;
|
|
|
|
#define __ENUMERATE_ARIA_ATTRIBUTE(attribute, referencing_attribute) \
|
|
GC::Ptr<DOM::Element> attribute() const; \
|
|
void set_##attribute(GC::Ptr<DOM::Element> value);
|
|
ENUMERATE_ARIA_ELEMENT_REFERENCING_ATTRIBUTES
|
|
#undef __ENUMERATE_ARIA_ATTRIBUTE
|
|
|
|
#define __ENUMERATE_ARIA_ATTRIBUTE(attribute, referencing_attribute) \
|
|
Optional<Vector<WeakPtr<DOM::Element>>> const& attribute() const; \
|
|
void set_##attribute(Optional<Vector<WeakPtr<DOM::Element>>>); \
|
|
\
|
|
GC::Ptr<JS::Array> cached_##attribute() const; \
|
|
void set_cached_##attribute(GC::Ptr<JS::Array>);
|
|
ENUMERATE_ARIA_ELEMENT_LIST_REFERENCING_ATTRIBUTES
|
|
#undef __ENUMERATE_ARIA_ATTRIBUTE
|
|
|
|
protected:
|
|
ARIAMixin();
|
|
|
|
void visit_edges(GC::Cell::Visitor&);
|
|
|
|
virtual bool id_reference_exists(String const&) const = 0;
|
|
|
|
private:
|
|
#define __ENUMERATE_ARIA_ATTRIBUTE(attribute, referencing_attribute) \
|
|
WeakPtr<DOM::Element> m_##attribute;
|
|
ENUMERATE_ARIA_ELEMENT_REFERENCING_ATTRIBUTES
|
|
#undef __ENUMERATE_ARIA_ATTRIBUTE
|
|
|
|
#define __ENUMERATE_ARIA_ATTRIBUTE(attribute, referencing_attribute) \
|
|
Optional<Vector<WeakPtr<DOM::Element>>> m_##attribute; \
|
|
GC::Ptr<JS::Array> m_cached_##attribute;
|
|
ENUMERATE_ARIA_ELEMENT_LIST_REFERENCING_ATTRIBUTES
|
|
#undef __ENUMERATE_ARIA_ATTRIBUTE
|
|
};
|
|
|
|
}
|