LibWeb: Move ARIA-related code into the Web::ARIA namespace

ARIA has its own spec and is not part of the DOM spec, which is what the
Web::DOM namespace is for (https://www.w3.org/TR/wai-aria-1.2/).

This allows us to stay closer to the spec with function names and don't
have to add the word "ARIA" to identifiers constantly - the namespace
now provides that clarity.

1 files changed, 172 insertions, 0 deletions

diff --git a/Userland/Libraries/LibWeb/ARIA/Roles.cpp b/Userland/Libraries/LibWeb/ARIA/Roles.cpp
new file mode 100644
index 0000000000..061194191e
--- /dev/null
+++ b/Userland/Libraries/LibWeb/ARIA/Roles.cpp
@@ -0,0 +1,172 @@
+/*
+ * Copyright (c) 2022, Jonah Shafran <jonahshafran@gmail.com>
+ *
+ * SPDX-License-Identifier: BSD-2-Clause
+ */
+
+#include <AK/GenericShorthands.h>
+#include <LibWeb/ARIA/Roles.h>
+
+namespace Web::ARIA {
+
+StringView role_name(Role role)
+{
+    switch (role) {
+#define __ENUMERATE_ARIA_ROLE(name) \
+    case Role::name:                \
+        return #name##sv;
+        ENUMERATE_ARIA_ROLES
+#undef __ENUMERATE_ARIA_ROLE
+    default:
+        VERIFY_NOT_REACHED();
+    }
+}
+
+Optional<Role> role_from_string(StringView role_name)
+{
+#define __ENUMERATE_ARIA_ROLE(name)                \
+    if (role_name.equals_ignoring_case(#name##sv)) \
+        return Role::name;
+    ENUMERATE_ARIA_ROLES
+#undef __ENUMERATE_ARIA_ROLE
+    return {};
+}
+
+// https://www.w3.org/TR/wai-aria-1.2/#abstract_roles
+bool is_abstract_role(Role role)
+{
+    return first_is_one_of(role,
+        Role::command,
+        Role::composite,
+        Role::input,
+        Role::landmark,
+        Role::range,
+        Role::roletype,
+        Role::section,
+        Role::sectionhead,
+        Role::select,
+        Role::structure,
+        Role::widget,
+        Role::window);
+}
+
+// https://www.w3.org/TR/wai-aria-1.2/#widget_roles
+bool is_widget_role(Role role)
+{
+    return first_is_one_of(role,
+        Role::button,
+        Role::checkbox,
+        Role::gridcell,
+        Role::link,
+        Role::menuitem,
+        Role::menuitemcheckbox,
+        Role::option,
+        Role::progressbar,
+        Role::radio,
+        Role::scrollbar,
+        Role::searchbox,
+        Role::separator, // TODO: Only when focusable
+        Role::slider,
+        Role::spinbutton,
+        Role::switch_,
+        Role::tab,
+        Role::tabpanel,
+        Role::textbox,
+        Role::treeitem,
+        Role::combobox,
+        Role::grid,
+        Role::listbox,
+        Role::menu,
+        Role::menubar,
+        Role::radiogroup,
+        Role::tablist,
+        Role::tree,
+        Role::treegrid);
+}
+
+// https://www.w3.org/TR/wai-aria-1.2/#document_structure_roles
+bool is_document_structure_role(Role role)
+{
+    return first_is_one_of(role,
+        Role::application,
+        Role::article,
+        Role::blockquote,
+        Role::caption,
+        Role::cell,
+        Role::columnheader,
+        Role::definition,
+        Role::deletion,
+        Role::directory,
+        Role::document,
+        Role::emphasis,
+        Role::feed,
+        Role::figure,
+        Role::generic,
+        Role::group,
+        Role::heading,
+        Role::img,
+        Role::insertion,
+        Role::list,
+        Role::listitem,
+        Role::math,
+        Role::meter,
+        Role::none,
+        Role::note,
+        Role::paragraph,
+        Role::presentation,
+        Role::row,
+        Role::rowgroup,
+        Role::rowheader,
+        Role::separator, // TODO: Only when not focusable
+        Role::strong,
+        Role::subscript,
+        Role::table,
+        Role::term,
+        Role::time,
+        Role::toolbar,
+        Role::tooltip);
+}
+
+// https://www.w3.org/TR/wai-aria-1.2/#landmark_roles
+bool is_landmark_role(Role role)
+{
+    return first_is_one_of(role,
+        Role::banner,
+        Role::complementary,
+        Role::contentinfo,
+        Role::form,
+        Role::main,
+        Role::navigation,
+        Role::region,
+        Role::search);
+}
+
+// https://www.w3.org/TR/wai-aria-1.2/#live_region_roles
+bool is_live_region_role(Role role)
+{
+    return first_is_one_of(role,
+        Role::alert,
+        Role::log,
+        Role::marquee,
+        Role::status,
+        Role::timer);
+}
+
+// https://www.w3.org/TR/wai-aria-1.2/#window_roles
+bool is_windows_role(Role role)
+{
+    return first_is_one_of(role,
+        Role::alertdialog,
+        Role::dialog);
+}
+
+bool is_non_abstract_role(Role role)
+{
+    return is_widget_role(role)
+        || is_document_structure_role(role)
+        || is_landmark_role(role)
+        || is_live_region_role(role)
+        || is_windows_role(role);
+}
+
+}