Luce packages
LuceLuce BaseLuciaOS

dymokomi/luce-browser-engine

Source of release 0.6.1

0.6.1 / src / web / aria / roles.lucb

#==============================================================================================
#
#   roles - ARIA::Role: the role names and the role categories of WAI-ARIA
#
#   DESCRIPTION:
#       Port of Libraries/LibWeb/ARIA/Roles.cpp (lines 1-192) with Roles.h's
#       ENUMERATE_ARIA_ROLES, expanded in the macro's order.
#
#       Copyright (c) 2022, Jonah Shafran <jonahshafran@gmail.com>
#       SPDX-License-Identifier: BSD-2-Clause
#
#==============================================================================================

# mark: Names ===================================================================================

## Ported from Libraries/LibWeb/ARIA/Roles.cpp:12 Web::ARIA::role_name.
pub func aria_role_name(role: AriaRole) -> ak.StringView:
    match role:
        .alert: return ak.sv("alert")
        .alertdialog: return ak.sv("alertdialog")
        .application: return ak.sv("application")
        .article: return ak.sv("article")
        .banner: return ak.sv("banner")
        .blockquote: return ak.sv("blockquote")
        .button: return ak.sv("button")
        .caption: return ak.sv("caption")
        .cell: return ak.sv("cell")
        .checkbox: return ak.sv("checkbox")
        .code: return ak.sv("code")
        .columnheader: return ak.sv("columnheader")
        .combobox: return ak.sv("combobox")
        .command: return ak.sv("command")
        .complementary: return ak.sv("complementary")
        .composite: return ak.sv("composite")
        .contentinfo: return ak.sv("contentinfo")
        .definition: return ak.sv("definition")
        .deletion: return ak.sv("deletion")
        .dialog: return ak.sv("dialog")
        .directory: return ak.sv("directory")
        .document: return ak.sv("document")
        .emphasis: return ak.sv("emphasis")
        .feed: return ak.sv("feed")
        .figure: return ak.sv("figure")
        .form: return ak.sv("form")
        .generic: return ak.sv("generic")
        .graphicsdocument: return ak.sv("graphics-document")
        .graphicsobject: return ak.sv("graphics-object")
        .graphicssymbol: return ak.sv("graphics-symbol")
        .grid: return ak.sv("grid")
        .gridcell: return ak.sv("gridcell")
        .group: return ak.sv("group")
        .heading: return ak.sv("heading")
        .image: return ak.sv("image")
        .img: return ak.sv("img")
        .input: return ak.sv("input")
        .insertion: return ak.sv("insertion")
        .landmark: return ak.sv("landmark")
        .link: return ak.sv("link")
        .list: return ak.sv("list")
        .listbox: return ak.sv("listbox")
        .listitem: return ak.sv("listitem")
        .log: return ak.sv("log")
        .main: return ak.sv("main")
        .mark: return ak.sv("mark")
        .marquee: return ak.sv("marquee")
        .math: return ak.sv("math")
        .meter: return ak.sv("meter")
        .menu: return ak.sv("menu")
        .menubar: return ak.sv("menubar")
        .menuitem: return ak.sv("menuitem")
        .menuitemcheckbox: return ak.sv("menuitemcheckbox")
        .menuitemradio: return ak.sv("menuitemradio")
        .navigation: return ak.sv("navigation")
        .none_: return ak.sv("none")
        .note: return ak.sv("note")
        .option: return ak.sv("option")
        .paragraph: return ak.sv("paragraph")
        .presentation: return ak.sv("presentation")
        .progressbar: return ak.sv("progressbar")
        .radio: return ak.sv("radio")
        .radiogroup: return ak.sv("radiogroup")
        .range: return ak.sv("range")
        .region: return ak.sv("region")
        .roletype: return ak.sv("roletype")
        .row: return ak.sv("row")
        .rowgroup: return ak.sv("rowgroup")
        .rowheader: return ak.sv("rowheader")
        .scrollbar: return ak.sv("scrollbar")
        .search: return ak.sv("search")
        .searchbox: return ak.sv("searchbox")
        .section: return ak.sv("section")
        .sectionfooter: return ak.sv("sectionfooter")
        .sectionhead: return ak.sv("sectionhead")
        .sectionheader: return ak.sv("sectionheader")
        .select: return ak.sv("select")
        .separator: return ak.sv("separator")
        .slider: return ak.sv("slider")
        .spinbutton: return ak.sv("spinbutton")
        .status: return ak.sv("status")
        .strong: return ak.sv("strong")
        .structure: return ak.sv("structure")
        .subscript: return ak.sv("subscript")
        .suggestion: return ak.sv("suggestion")
        .superscript: return ak.sv("superscript")
        .switch: return ak.sv("switch")
        .tab: return ak.sv("tab")
        .table: return ak.sv("table")
        .tablist: return ak.sv("tablist")
        .tabpanel: return ak.sv("tabpanel")
        .term: return ak.sv("term")
        .textbox: return ak.sv("textbox")
        .time: return ak.sv("time")
        .timer: return ak.sv("timer")
        .toolbar: return ak.sv("toolbar")
        .tooltip: return ak.sv("tooltip")
        .tree: return ak.sv("tree")
        .treegrid: return ak.sv("treegrid")
        .treeitem: return ak.sv("treeitem")
        .widget: return ak.sv("widget")
        .window: return ak.sv("window")
        _: trap("VERIFY_NOT_REACHED")

## Ported from Libraries/LibWeb/ARIA/Roles.cpp:25 Web::ARIA::role_from_string.
pub func aria_role_from_string(role_name: ak.StringView) -> AriaRole?:
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("alert")):
        return AriaRole.alert
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("alertdialog")):
        return AriaRole.alertdialog
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("application")):
        return AriaRole.application
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("article")):
        return AriaRole.article
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("banner")):
        return AriaRole.banner
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("blockquote")):
        return AriaRole.blockquote
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("button")):
        return AriaRole.button
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("caption")):
        return AriaRole.caption
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("cell")):
        return AriaRole.cell
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("checkbox")):
        return AriaRole.checkbox
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("code")):
        return AriaRole.code
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("columnheader")):
        return AriaRole.columnheader
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("combobox")):
        return AriaRole.combobox
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("command")):
        return AriaRole.command
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("complementary")):
        return AriaRole.complementary
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("composite")):
        return AriaRole.composite
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("contentinfo")):
        return AriaRole.contentinfo
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("definition")):
        return AriaRole.definition
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("deletion")):
        return AriaRole.deletion
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("dialog")):
        return AriaRole.dialog
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("directory")):
        return AriaRole.directory
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("document")):
        return AriaRole.document
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("emphasis")):
        return AriaRole.emphasis
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("feed")):
        return AriaRole.feed
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("figure")):
        return AriaRole.figure
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("form")):
        return AriaRole.form
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("generic")):
        return AriaRole.generic
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("graphics-document")):
        return AriaRole.graphicsdocument
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("graphics-object")):
        return AriaRole.graphicsobject
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("graphics-symbol")):
        return AriaRole.graphicssymbol
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("grid")):
        return AriaRole.grid
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("gridcell")):
        return AriaRole.gridcell
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("group")):
        return AriaRole.group
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("heading")):
        return AriaRole.heading
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("image")):
        return AriaRole.image
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("img")):
        return AriaRole.img
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("input")):
        return AriaRole.input
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("insertion")):
        return AriaRole.insertion
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("landmark")):
        return AriaRole.landmark
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("link")):
        return AriaRole.link
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("list")):
        return AriaRole.list
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("listbox")):
        return AriaRole.listbox
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("listitem")):
        return AriaRole.listitem
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("log")):
        return AriaRole.log
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("main")):
        return AriaRole.main
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("mark")):
        return AriaRole.mark
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("marquee")):
        return AriaRole.marquee
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("math")):
        return AriaRole.math
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("meter")):
        return AriaRole.meter
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("menu")):
        return AriaRole.menu
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("menubar")):
        return AriaRole.menubar
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("menuitem")):
        return AriaRole.menuitem
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("menuitemcheckbox")):
        return AriaRole.menuitemcheckbox
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("menuitemradio")):
        return AriaRole.menuitemradio
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("navigation")):
        return AriaRole.navigation
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("none")):
        return AriaRole.none_
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("note")):
        return AriaRole.note
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("option")):
        return AriaRole.option
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("paragraph")):
        return AriaRole.paragraph
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("presentation")):
        return AriaRole.presentation
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("progressbar")):
        return AriaRole.progressbar
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("radio")):
        return AriaRole.radio
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("radiogroup")):
        return AriaRole.radiogroup
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("range")):
        return AriaRole.range
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("region")):
        return AriaRole.region
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("roletype")):
        return AriaRole.roletype
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("row")):
        return AriaRole.row
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("rowgroup")):
        return AriaRole.rowgroup
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("rowheader")):
        return AriaRole.rowheader
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("scrollbar")):
        return AriaRole.scrollbar
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("search")):
        return AriaRole.search
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("searchbox")):
        return AriaRole.searchbox
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("section")):
        return AriaRole.section
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("sectionfooter")):
        return AriaRole.sectionfooter
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("sectionhead")):
        return AriaRole.sectionhead
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("sectionheader")):
        return AriaRole.sectionheader
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("select")):
        return AriaRole.select
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("separator")):
        return AriaRole.separator
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("slider")):
        return AriaRole.slider
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("spinbutton")):
        return AriaRole.spinbutton
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("status")):
        return AriaRole.status
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("strong")):
        return AriaRole.strong
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("structure")):
        return AriaRole.structure
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("subscript")):
        return AriaRole.subscript
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("suggestion")):
        return AriaRole.suggestion
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("superscript")):
        return AriaRole.superscript
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("switch")):
        return AriaRole.switch
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("tab")):
        return AriaRole.tab
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("table")):
        return AriaRole.table
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("tablist")):
        return AriaRole.tablist
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("tabpanel")):
        return AriaRole.tabpanel
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("term")):
        return AriaRole.term
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("textbox")):
        return AriaRole.textbox
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("time")):
        return AriaRole.time
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("timer")):
        return AriaRole.timer
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("toolbar")):
        return AriaRole.toolbar
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("tooltip")):
        return AriaRole.tooltip
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("tree")):
        return AriaRole.tree
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("treegrid")):
        return AriaRole.treegrid
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("treeitem")):
        return AriaRole.treeitem
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("widget")):
        return AriaRole.widget
    if ak.string_view_equals_ignoring_ascii_case(&role_name, ak.sv("window")):
        return AriaRole.window
    return none

# mark: Categories ==============================================================================

## Ported from Libraries/LibWeb/ARIA/Roles.cpp:36 Web::ARIA::is_abstract_role.
# https://www.w3.org/TR/wai-aria-1.2/#abstract_roles
pub func aria_is_abstract_role(role: AriaRole) -> bool:
    match role:
        .command, .composite, .input, .landmark, .range, .roletype, .section, .sectionhead, .select, .structure, .widget, .window: return true
        _: return false

## Ported from Libraries/LibWeb/ARIA/Roles.cpp:54 Web::ARIA::is_widget_role.
# https://www.w3.org/TR/wai-aria-1.2/#widget_roles
pub func aria_is_widget_role(role: AriaRole) -> bool:
    match role:
        # separator: TODO: Only when focusable
        .button, .checkbox, .gridcell, .link, .menuitem, .menuitemcheckbox, .menuitemradio, .option, .progressbar, .radio, .scrollbar, .searchbox, .separator, .slider, .spinbutton, .switch, .tab, .tabpanel, .textbox, .treeitem, .combobox, .grid, .listbox, .menu, .menubar, .radiogroup, .tablist, .tree, .treegrid: return true
        _: return false

## Ported from Libraries/LibWeb/ARIA/Roles.cpp:89 Web::ARIA::is_document_structure_role.
# https://www.w3.org/TR/wai-aria-1.2/#document_structure_roles
pub func aria_is_document_structure_role(role: AriaRole) -> bool:
    match role:
        # separator: TODO: Only when not focusable
        .application, .article, .blockquote, .caption, .cell, .code, .columnheader, .definition, .deletion, .directory, .document, .emphasis, .feed, .figure, .generic, .group, .heading, .img, .insertion, .list, .listitem, .math, .meter, .none_, .note, .paragraph, .presentation, .row, .rowgroup, .rowheader, .separator, .strong, .subscript, .suggestion, .superscript, .table, .term, .time, .toolbar, .tooltip: return true
        _: return false

## Ported from Libraries/LibWeb/ARIA/Roles.cpp:135 Web::ARIA::is_landmark_role.
# https://www.w3.org/TR/wai-aria-1.2/#landmark_roles
pub func aria_is_landmark_role(role: AriaRole) -> bool:
    match role:
        .banner, .complementary, .contentinfo, .form, .main, .navigation, .region, .search: return true
        _: return false

## Ported from Libraries/LibWeb/ARIA/Roles.cpp:149 Web::ARIA::is_live_region_role.
# https://www.w3.org/TR/wai-aria-1.2/#live_region_roles
pub func aria_is_live_region_role(role: AriaRole) -> bool:
    match role:
        .alert, .log, .marquee, .status, .timer: return true
        _: return false

## Ported from Libraries/LibWeb/ARIA/Roles.cpp:160 Web::ARIA::is_windows_role.
# https://www.w3.org/TR/wai-aria-1.2/#window_roles
pub func aria_is_windows_role(role: AriaRole) -> bool:
    match role:
        .alertdialog, .dialog: return true
        _: return false

## Ported from Libraries/LibWeb/ARIA/Roles.cpp:168 Web::ARIA::allows_name_from_content.
# https://www.w3.org/TR/wai-aria-1.2/#namefromcontent
pub func aria_allows_name_from_content(role: AriaRole) -> bool:
    match role:
        .button, .cell, .checkbox, .columnheader, .gridcell, .heading, .link, .menuitem, .menuitemcheckbox, .menuitemradio, .option, .radio, .row, .rowheader, .sectionhead, .switch, .tab, .tooltip, .treeitem: return true
        _: return false