Attribut global HTMLAttributs globaux

aria-*

Les attributs ARIA décrivent les éléments pour les lecteurs d’écran : ils leur donnent des noms, les relient à des descriptions et signalent leur état.

S’applique à
Tous les éléments HTML, mais chaque attribut ARIA a ses propres règles d’utilisation
Sur cette page

Exemple

#
HTML
<style>
  .menu-button { padding: 6px 10px; font-size: 18px; line-height: 1; }
  .menu { list-style: none; margin: 10px 0 0; padding: 0; }
  .menu li { margin-bottom: 6px; }
  .menu a { color: #d4d4d4; }
  .menu a[aria-current="page"] { color: #c4b5fd; font-weight: 600; }
</style>

<button type="button" class="menu-button"
  aria-label="Menu" aria-expanded="false" aria-controls="main-menu"
  onclick="
    const open = this.getAttribute('aria-expanded') === 'true';
    this.setAttribute('aria-expanded', String(!open));
    document.getElementById('main-menu').hidden = open;
  ">
  <span aria-hidden="true">☰</span>
</button>

<ul class="menu" id="main-menu" hidden>
  <li><a href="#">Formations</a></li>
  <li><a href="#" aria-current="page">Documentation</a></li>
  <li><a href="#">Tarifs</a></li>
</ul>
Aperçu

Le bouton n’a qu’une icône, il reçoit donc le nom « Menu » grâce à aria-label, et l’icône elle-même est masquée aux lecteurs par aria-hidden. Un clic bascule aria-expanded, et aria-current="page" désigne la page actuelle. Ce dernier attribut est aussi utilisé ici par le CSS, qui met en valeur le lien actif.

Définition et utilisation

#

Les attributs commençant par aria- proviennent de la spécification WAI-ARIA. Ils complètent les informations que les technologies d’assistance, comme les lecteurs d’écran, lisent dans la page : comment s’appelle un élément, ce qui le décrit, s’il est déplié, s’il désigne la page actuelle. Ils ne changent rien à l’écran, et le navigateur n’ajoute aucun comportement par leur intermédiaire.

Avant d’y recourir, rappelez-vous la première règle d’ARIA : si un élément HTML natif fournit le nom et l’état dont vous avez besoin, utilisez-le. Un <label> nomme un champ mieux que aria-label, car tout le monde voit son texte, et <details> se déplie et signale son état sans aria-expanded. ARIA sert dans les situations que HTML ne gère pas seul : un bouton avec une simple icône, un menu déroulant personnalisé, des messages qui apparaissent sans rechargement de la page.

En pratique, on utilise surtout trois groupes d’attributs. Les noms et descriptions (aria-label, aria-labelledby, aria-describedby) indiquent comment s’appelle un élément et ce qu’il est utile de savoir sur lui. Les états (aria-expanded, aria-current, aria-hidden) se modifient par script en même temps que l’interface. Les régions dynamiques (aria-live) font en sorte que le lecteur annonce un nouveau contenu alors que l’utilisateur se trouve ailleurs dans la page.

ARIA ne se met pas à jour toute seule. Si un bouton a aria-expanded="false" et qu’un menu se déplie au clic, un script doit changer la valeur en true. Un état périmé induit plus en erreur que l’absence d’état.

Syntaxe

#
Syntaxe
<element aria-nom="valeur">…</element>

Les attributs aria-* les plus importants

#
  • aria-label

    texte

    Le nom de l’élément pour les lecteurs d’écran lorsqu’il n’y a pas de texte visible, par exemple un bouton avec une simple icône. Il remplace le contenu de l’élément. Sur un simple <div> ou <span> sans rôle, les lecteurs l’ignorent généralement.
  • aria-labelledby

    liste d’id

    Un nom repris d’un autre élément, par exemple du titre d’une section. Vous pouvez indiquer plusieurs identifiants séparés par des espaces. Il est prioritaire sur aria-label.
  • aria-describedby

    liste d’id

    Désigne une description supplémentaire, par exemple une indication pour un champ ou un message d’erreur. Le lecteur la lit après le nom de l’élément.
  • aria-hidden

    true | false

    Masque l’élément et tout son contenu aux lecteurs d’écran, mais pas à l’écran. Pour les icônes et les ornements. Ne masquez jamais ainsi des éléments pouvant recevoir le focus.
  • aria-expanded

    true | false

    L’état d’un bouton qui affiche et masque une autre partie de la page, par exemple un menu ou une réponse dans une FAQ. Mettez-le à jour par script à chaque clic.
  • aria-current

    page | step | location | date | time | true

    Désigne l’élément courant dans un ensemble : le lien actif dans un menu (page), l’étape actuelle d’un formulaire (step) ou la date du jour dans un calendrier (date).
  • aria-live

    off | polite | assertive

    Transforme l’élément en région dynamique : le lecteur annonce les changements de son contenu. polite attend que le lecteur ait fini de parler, et assertive l’interrompt aussitôt. La région doit exister dans la page avant que vous ne changiez son contenu.

Plus d’exemples

#
Une indication pour un champ et un message en direct
HTML
<style>
  .hint { margin: 4px 0 8px; color: #a3a3a3; font-size: 14px; }
</style>

<form onsubmit="
  event.preventDefault();
  const nick = this.elements.nick.value.trim();
  const valid = nick.length >= 3 && nick.length <= 16 && !nick.includes(' ');
  document.getElementById('nick-status').textContent = valid
    ? 'Pseudo ' + nick + ' enregistré.'
    : 'Un pseudo doit comporter de 3 à 16 caractères et ne peut pas contenir d’espaces.';
">
  <label for="nick">Pseudo dans le classement</label>
  <input id="nick" name="nick" type="text" aria-describedby="nick-hint">
  <p id="nick-hint" class="hint">De 3 à 16 caractères, sans espaces.</p>
  <button>Enregistrer le pseudo</button>
  <p id="nick-status" aria-live="polite"></p>
</form>
Aperçu

Un lecteur d’écran lira le nom du champ d’après l’étiquette, puis l’indication désignée par aria-describedby. Le résultat de l’enregistrement va dans un paragraphe avec aria-live="polite" présent sur la page dès le départ, le lecteur annonce donc le message alors que le focus reste sur le bouton.

Compatibilité des navigateurs

#

Largement disponible

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Ne donnez pas aria-label à des éléments avec un texte visible qui dit autre chose. Les personnes qui commandent leur ordinateur à la voix prononcent ce qu’elles voient à l’écran, et le programme ne connaît que le nom donné par ARIA.
  • aria-hidden="true" sur un élément pouvant recevoir le focus crée un « fantôme » : le clavier s’y arrête, mais le lecteur d’écran reste muet. Masquez de tels éléments avec l’attribut hidden ou inert.
  • Vérifiez l’effet dans un vrai lecteur d’écran. Sur Mac, VoiceOver est intégré (Cmd + F5), et sous Windows vous pouvez télécharger le logiciel gratuit NVDA.

Entrées associées

#

Pratiquer dans les leçons

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.