Using the aria-relevant attribute

The aria-relevant attribute is an optional value used to describe what types of changes have occurred to an aria-live region, and which are relevant and should be announced. Any change that is not relevant acts in the same manner it would if the aria-live attribute were set to off.

Aria-relevant is commonly used when a web page contains content that may be updated while viewing the page.

Values

A space-delimited list of one or more of the following values:

  • "additions" are insertion of nodes into the live region; should be considered relevant.
  • "removals" are deletion of nodes; should be considered relevant.
  • "text" are changes to the textual content of existing nodes; should be considered relevant.
  • "all"  is equivalent to additions removals text.

aria-relevant="additions text" is the default value on a live region.

Additional resources

Document Tags and Contributors

Contributors to this page: jamesdhurd, thenoelman, MichielBijl, dcondrey
Last updated by: jamesdhurd,