aria-* – attributs d’accessibilité
<button aria-label="Fermer" aria-expanded="false">…</button>
Les attributs WAI-ARIA complètent l’arbre d’accessibilité – ce que les utilisateurs de lecteurs d’écran entendent et savent d’un élément : son nom, sa description, son état (déplié, sélectionné, invalide) et les relations entre éléments. Ils n’agissent ni sur l’apparence ni sur le comportement. La première règle d’ARIA dit : s’il existe un élément HTML pour cela (button, nav, label), utilisez-le – ARIA ne sert qu’à ce que HTML ne sait pas faire.
Valeurs
- aria-label – nom de l’élément quand il n’a pas de texte visible (bouton avec icône).
- aria-labelledby – nom tiré d’un autre élément (id du titre d’une fenêtre ou d’une section).
- aria-describedby – description supplémentaire tirée d’un autre élément (aide, erreur près d’un champ).
- aria-expanded – la partie commandée est-elle dépliée (
true/false) ; aria-controls – id de la partie commandée. - aria-current – élément actuel (
pagedans un menu,stepdans un processus). - aria-hidden avec
true– masque l’élément aux lecteurs d’écran (icônes décoratives) ; il reste visible. - aria-live – zone dont le lecteur d’écran annonce les changements :
polite(quand il a fini de parler),assertive(immédiatement). - aria-invalid, aria-required, aria-pressed, aria-selected, aria-checked – états.
- S’applique à : tous les éléments (chaque attribut seulement pour les rôles auxquels il est destiné)
- En JavaScript :
element.ariaLabel, element.ariaExpanded… (ou getAttribute('aria-label'))
Exemples
Un bouton avec icône, un menu déroulant et une erreur près d’un champ :
<button type="button" aria-label="Fermer"> <svg viewBox="0 0 24 24" width="16" height="16" aria-hidden="true"><path fill="currentColor" d="M5 5l14 14M19 5L5 19" stroke="currentColor" stroke-width="2"/></svg> </button> <button type="button" aria-expanded="false" aria-controls="menu-list">Menu</button> <ul id="menu-list" hidden>…</ul> <label for="e-email">E-mail</label> <input type="email" id="e-email" aria-invalid="true" aria-describedby="e-error"> <p id="e-error">Saisissez l’adresse e-mail au format marie@example.com.</p>
Une zone dont le lecteur d’écran annonce les changements (ajout au panier) :
<p aria-live="polite" id="cart-message"></p>
Accessibilité
Un mauvais ARIA nuit plus que son absence : aria-hidden="true" sur un élément avec le focus, un aria-label qui ne correspond pas au texte visible, ou un aria-expanded que le script ne met pas à jour. L’état ARIA doit toujours correspondre à la réalité – le navigateur ne le change pas à votre place.
Points d’attention
- Les lecteurs d’écran ignorent
aria-labelsur un élément sans rôle (div,span). - Le texte visible d’un bouton doit figurer dans son
aria-label– les utilisateurs de la commande vocale disent ce qu’ils voient. - Une zone avec
aria-livedoit être dans la page avant que le texte n’y arrive – une zone dynamique insérée avec son texte n’est souvent pas annoncée. - Les éléments HTML ont leurs propres rôles et états :
buttonn’a pas besoin derole="button", etdetailsn’a pas besoin dearia-expanded.
Voir aussi :
role – rôle de l’élément (attribut)
label – étiquette du champ
button – bouton
hidden – élément masqué (attribut)
inert – partie inactive de la page (attribut)