aria-relevant
Définit quels types de changements dans une région live doivent être annoncés par les technologies d'assistance.
Description
aria-relevant précise quels événements de modification déclenchent une annonce dans une région live. Les valeurs peuvent être combinées (séparées par des espaces) :
additions— annonce les nœuds ajoutésremovals— annonce les nœuds suppriméstext— annonce les changements de contenu textuelall— annonce tout type de changement- Valeur par défaut :
additions text
Syntaxe
<ul aria-live="polite" aria-relevant="additions removals">
<!-- Annonce les ajouts ET les suppressions d'éléments -->
</ul>
Exemples
Log de chat (nouveaux messages uniquement) :
<ol aria-live="polite"
aria-relevant="additions"
aria-label="Messages du chat">
<!-- Seuls les nouveaux messages sont annoncés -->
</ol>
Liste de participants (entrées et sorties) :
<ul aria-live="polite"
aria-relevant="additions removals"
aria-label="Participants connectés">
<li>Alice</li>
<li>Bob</li>
</ul>
Notes
Défaut additions text : la grande majorité des cas d’usage n’a pas besoin de spécifier aria-relevant — le défaut couvre les scénarios les plus courants.
removals avec parcimonie : les suppressions sont rarement importantes pour l’utilisateur. L’utiliser uniquement quand l’absence d’un élément est significative (participant déconnecté, notification effacée).
all rarement utile : annonce tous les changements, y compris les attributs CSS — peut générer du bruit inutile.