Valid ARIA Role Names Lookup

Classifies individual WAI-ARIA 1.2 role names in their recommended lowercase author spelling as concrete, abstract or unknown. This exact-spelling vocabulary lookup excludes extensions and browser case-insensitive processing.

Description

Concrete ARIA roles describe interface semantics.

Concrete ARIA roles describe interface semantics. Abstract roles organize the specification and are not author roles for use on elements.1

Classifies individual WAI-ARIA 1.2 role names in their recommended lowercase author spelling as concrete, abstract or unknown. This exact-spelling vocabulary lookup excludes extensions and browser case-insensitive processing.

When to use Valid ARIA Role Names Lookup

Use this for the following task: Classifies individual WAI-ARIA 1.2 role names in their recommended lowercase author spelling as concrete, abstract or unknown. This exact-spelling vocabulary lookup excludes extensions and browser case-insensitive processing.

Prepare the parsed attribute values, element states or ordered local lists requested below. Keep attribute presence separate from value.

How to use Valid ARIA Role Names Lookup and understand its results

  1. Prepare the parsed attribute values, element states or ordered local lists requested below. Keep attribute presence separate from value.
  2. Enter roles using the field table, then run the tool.
  3. Read valid, abstract. Interpret flags, units, ordering and placeholder values using the rules below.
  4. Review any reported issue or failed check, correct the supplied values when appropriate, and verify the result in its intended context.
Input fieldMeaningValue type and boundsRequirement
rolesRoleslist of string; minimum entries 0; maximum entries 10000; each entry: string; maximum text length 10000Required

Supply individual lowercase role names. Preserve input order and test each against the WAI-ARIA 1.2 concrete and abstract vocabularies. Unknown names produce two false flags.2

valid[i] = concrete-role membership; abstract[i] = abstract-role membership

This summarizes the declared operation. Units, indexing, inclusivity and exceptional cases are explained in the surrounding text.

Output fieldMeaningValue type
validValidlist of boolean
abstractAbstractlist of boolean
json
{
  "input": {
    "roles": [
      "button",
      "widget",
      "BUTTON",
      "none"
    ]
  },
  "output": {
    "valid": [
      true,
      false,
      false,
      true
    ],
    "abstract": [
      false,
      true,
      false,
      false
    ]
  }
}

Limitations and assumptions

This does not parse a space-separated role attribute, include extension roles or emulate browser case-insensitive processing.

This evaluates supplied local information; it does not fetch a page or run a browser. Malformed requests produce input errors. A successfully evaluated request can still contain false flags, empty result lists or a result outside the supplied threshold; those outcomes have the meanings stated above.

Alternative or Complementary methods

Choose ARIA State Attribute Pair Check for this operation: Checks a WAI-ARIA 1.2 state attribute name and a defined value token in recommended lowercase author spelling. This exact-spelling lexical pair check does not evaluate browser error recovery, role applicability or accessibility. For a complementary task, use role=presentation vs none Equivalence for this operation: Resolves equivalent presentation/none roles on an element, including focusable or otherwise interactive elements and global ARIA conflict resolution. Reports removal of this element's own implicit semantics; required owned descendants need separate checks.

Further background: HTML / accessibility reference: Valid ARIA Role Names Lookup.

References

  1. HTML / accessibility reference: Valid ARIA Role Names Lookup — W3C

  2. Valid ARIA Role Names Lookup — tool.io

Similar or alternative tools

  • ARIA State Attribute Pair Check

    Checks a WAI-ARIA 1.2 state attribute name and a defined value token in recommended lowercase author spelling. This exact-spelling lexical pair check does not evaluate browser error recovery, role applicability or accessibility.

  • role=presentation vs none Equivalence

    Resolves equivalent presentation/none roles on an element, including focusable or otherwise interactive elements and global ARIA conflict resolution. Reports removal of this element's own implicit semantics; required owned descendants need separate checks.

Don't forget to set a bookmark for tool.io!
Privacy | Imprint | Cookies