Used in ARIA live regions, the global
aria-relevant attribute indicates what notifications the user agent will trigger when the accessibility tree within a live region is modified.
ARIA live regions are areas of a web page that are updated when user's attention may be elsewhere. When an update is outside of the user's keyboard focus, assistive technologies such as screen readers use a live region area to report updates to the user.
Examples of live regions include news marquees, stock tickers, chat windows, and score boards. These update without user interaction. Some updates are important for the user to know about. They're relevant. Others are not. The
aria-relevant is used to describe what types of changes have occurred to an
aria-live region, and which are relevant and should be announced.
The value is a space-separated list of change types, including
text, with a shorthand
all meaning all three.
aria-relevant is not defined, the value is inherited from the nearest ancestor with a defined value. Inherited values are not additive; the value provided on a descendant element completely overrides any inherited value from an ancestor element. When a live region doesn't have an
aria-relevant attribute set and has no ancestor with it set, it defaults to
additions text, because generally text modifications and node additions are relevant, but node removals are not.
While not a supported value, if the value of
none makes the most sense, it should not be a live region.
The values of
all should be used sparingly. For example, when a goal happens in the World Cup, the new score (the addition) is important, the old value (the removal) is not. Assistive technologies only need to be informed of content removal when its removal represents an important change, such as a when a player is taken out of the game.
Element nodes are added to the accessibility tree within the live region.
additions removals text.
Text content, a text alternative, or an element node within the live region is removed from the accessibility tree.
Text content or a text alternative is added to any descendant in the accessibility tree of the live region.
Element nodes are added to the accessibility tree within the live region AND text content or a text alternative is added to any descendant in the accessibility tree of the live region.
Used in ALL roles.
|Accessible Rich Internet Applications (WAI-ARIA) 1.1
The definition of 'ARIA: aria-relevant Attribute' in that specification.