aria-relevant
Token listSpecifies which kinds of changes within a live region are worth announcing — additions, removals, text, or all. The default, 'additions text', announces added nodes and text changes but not removals. It's an optional refinement of aria-live that screen readers honor inconsistently, so rely on it lightly.
Values
- additions
- Announce nodes added to the live region.
- removals
- Announce nodes removed from the live region.
- text
- Announce text changes within the live region.
- additions text (default)
- Announce additions and text changes.
- all
- Announce additions, removals, and text changes.
Used on
Any HTML element —
aria-relevant is a global property.Associated roles
Every ARIA role. As a global property,
aria-relevant is supported on all roles.Example
aria-relevant="…"
<ul aria-live="polite" aria-relevant="additions">…</ul>References