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 Element nodes added to the accessibility tree within the live region; should be considered relevant.
  • removals are deletion of nodes in the accessiblity tree; 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