aria-relevant attribute | ariaRelevant property

Sets or retrieves which changes to a live region are relevant.


<element aria-relevant="p" ... >


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


Used in Roles
No role required.


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.

Note  For cross-browser compatibility, always use the WAI-ARIA attribute syntax to access and modify ARIA properties, for example object.setAttribute("aria-valuenow", newValue).

See also

Accessible Rich Internet Applications (ARIA)



© 2017 Microsoft