Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

aria-label — un nom accessible textuel

`aria-label` attribue un nom accessible à un élément dont le rôle autorise une dénomination fournie par l’auteur.

Version : WAI-ARIA 1.2

Syntaxe

<button aria-label="Close notice">×</button>

Fournissez un nom d’action bref et traduit, par exemple Close notice pour un bouton de fermeture. L’attribut ne donne pas de rôle à un élément quelconque. Lorsqu’un texte visible ou une étiquette native est possible, cette solution est généralement préférable.

Le nom peut remplacer le texte du contenu. Incluez l’étiquette visible pour que la commande vocale corresponde à l’écran. Un aria-labelledby valide est prioritaire. Ce n’est ni une infobulle, ni un mode d’emploi, ni un gestionnaire d’événement.

Le bouton à icône de l’exemple porte le nom Close notice, tandis que son signe décoratif est exclu de l’accessibilité. Une fonction distincte masque la notification lors de l’activation. Le test confirme le nom calculé et la fermeture ; traduisez l’étiquette avec l’interface.

Exemples

<!doctype html><meta charset="utf-8">
<p id="notice">Your settings were saved.</p>
<button id="close" aria-label="Close notice"><span aria-hidden="true">×</span></button>
<output id="result"></output>
<script>
document.querySelector('#close').addEventListener('click', () => { document.querySelector('#notice').hidden = true; });
document.querySelector('#close').click();
document.querySelector('#result').textContent = 'noticeHidden=' + document.querySelector('#notice').hidden;
</script>

Résultat

noticeHidden=true

Le nom et l’action du bouton ont été vérifiés ; ARIA seul ne ferme pas la notification.

Sources