aria-relevant attribute | ariaRelevant property
Sets or retrieves which changes to a live region are relevant.
 |
Syntax
| HTML |
|---|
<element aria-relevant="p" ... > |
| JavaScript |
|---|
object.setAttribute("aria-relevant",value);var value = object.getAttribute("aria-relevant");
|
Property values
Type: String
A space-delimited list of one or more of the following values:
-
Insertion of nodes into the live region should be considered relevant.
-
Deletion of nodes should be considered relevant.
-
Changes to the textual content of existing nodes should be considered relevant.
-
Equivalent to
additions removals text.
Standards information
- Accessible Rich Internet Applications (WAI-ARIA) 1.0, Section 6.6
Remarks
| Used in Roles |
|
|---|
The ariaRelevant setting gives a hint about what types of changes are relevant and should be announced by assistive technology. Any change that is not relevant should be treated as if the region had ariaLive="off" and should not be announced.
The default behavior is equivalent to additions text. Updates are announced only as nodes are added, or as text is added or removed.
object.setAttribute("aria-valuenow", newValue). See also