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
- Prepare the parsed attribute values, element states or ordered local lists requested below. Keep attribute presence separate from value.
- Enter value using the field table, then run the tool.
- Read priority, mayInterrupt. Interpret flags, units, ordering and placeholder values using the rules below.
- Review any reported issue or failed check, correct the supplied values when appropriate, and verify the result in its intended context.
| Input field | Meaning | Value type and bounds | Requirement |
|---|---|---|---|
| value | Value | string; 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 field | Meaning | Value type |
|---|---|---|
| priority | Priority | string |
| mayInterrupt | May Interrupt | boolean |
{
"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
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.