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
Exemple
#<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>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
#<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 suraria-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.politeattend que le lecteur ait fini de parler, etassertivel’interrompt aussitôt. La région doit exister dans la page avant que vous ne changiez son contenu.
Plus d’exemples
#<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>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’attributhiddenouinert.- 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
#- roleUn rôle ARIA indique aux lecteurs d’écran ce qu’est un élément : un bouton, un onglet, un message, une navigation.
- hiddenMasque l’élément : le navigateur ne l’affiche pas et ne l’expose pas.
- <label>L’étiquette d’un champ de formulaire. Cliquer sur l’étiquette déplace le curseur vers le champ.
- <button>Un bouton cliquable : il envoie un formulaire, le réinitialise, ou lance une action sur la page.
- inertDésactive l’interaction avec l’élément et ses descendants : clic, focus et lecteurs d’écran.
Pratiquer dans les leçons
#Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.