aria-live polite/assertive/off Lookup

Classifies aria-live priorities: polite waits for an appropriate idle opportunity, assertive may interrupt, and off permits updates associated with focus. Actual assistive-technology announcements are not guaranteed.

Description

Aria-live expresses when assistive technology may announce region updates.

Aria-live expresses when assistive technology may announce region updates. Polite, assertive and off differ in announcement priority and focus dependency.1

Classifies aria-live priorities: polite waits for an appropriate idle opportunity, assertive may interrupt, and off permits updates associated with focus. Actual assistive-technology announcements are not guaranteed.

When to use aria-live polite/assertive/off Lookup

Use this for the following task: Classifies aria-live priorities: polite waits for an appropriate idle opportunity, assertive may interrupt, and off permits updates associated with focus. Actual assistive-technology announcements are not guaranteed.

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

How to use aria-live polite/assertive/off 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 value using the field table, then run the tool.
  3. Read priority, mayInterrupt. 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
valueValuestring; choose "off", "polite", "assertive"Required

Select the supported exact token. Set mayInterrupt only for assertive and return focus-dependent priority for off.2

off → focus-dependent; polite → polite; assertive → assertive and mayInterrupt

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

Output fieldMeaningValue type
priorityPrioritystring
mayInterruptMay Interruptboolean
json
{
  "input": {
    "value": "assertive"
  },
  "output": {
    "priority": "assertive",
    "mayInterrupt": true
  }
}

Limitations and assumptions

This does not guarantee actual announcements or evaluate atomicity, relevance, focus or assistive-technology settings.

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 Valid ARIA Role Names Lookup for this operation: 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.

Further background: HTML / accessibility reference: aria-live polite/assertive/off Lookup.

References

  1. HTML / accessibility reference: aria-live polite/assertive/off Lookup — W3C

  2. aria-live polite/assertive/off 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.

  • 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.

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