Accueil >Web >Référence HTML – éléments et attributs >aria-* – attributs d’accessibilité

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 (page dans un menu, step dans 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-label sur 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-live doit ê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 : button n’a pas besoin de role="button", et details n’a pas besoin de aria-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)