Pas à pas

L'attribut aria-label : quand l'utiliser et comment l'écrire

10 min de lecture
Mikhail ShaymardanovExpert en Qualité et Accessibilité Web

Sur un bouton qui n'affiche qu'une icône et n'a pas de nom, le lecteur d'écran n'annonce que « bouton », sans dire à quoi il sert. L'attribut aria-label donne à l'élément le nom que le lecteur d'écran annonce. Il sert quand un bouton, un lien ou un champ n'affiche aucun texte pour le nommer. Nous expliquons quand l'utiliser, quoi y écrire, ce qui peut l'annuler et comment le vérifier.

Un nom pour chaque élément de l'en-tête


#À quoi sert l'attribut aria-label ?

aria-label est un attribut ARIA qui donne à un élément son nom accessible, celui que reçoivent les outils d'aide. Le lecteur d'écran prononce ce nom, en général avant le rôle, c'est-à-dire le type d'élément, et une personne qui pilote son téléphone à la voix le dit pour activer l'élément.

La page, elle, n'affiche pas la valeur d'aria-label, alors qu'un texte visible sert aussi les personnes sans outil d'aide. C'est pourquoi l'attribut se réserve aux éléments sans texte visible.

Pour les outils d'aide, aria-label remplace le contenu d'un bouton ou d'un lien, l'alt d'une image et le <label> d'un champ. Pour une image, gardez donc alt et suivez le guide du texte alternatif.

Le bouton menu d'Atelier Pignon, une boutique de vélos dont nous suivrons l'en-tête, ne contient qu'un dessin à trois traits.

Capture d'écran : bouton menu d'Atelier Pignon, un carré noir marqué de trois traits blancs, sans texte, à gauche du logo.Repère 1. Le bouton menu, qui ne montre que trois traits.
Le bouton menurepère 1 ne montre que trois traits : sans aria-label, le lecteur d'écran n'annonce que « bouton » ; avec « Menu », il dit « Menu, bouton ».

À éviter

<button type="button">
  <svg width="24" height="24" viewBox="0 0 24 24">…</svg>
</button>

Lecteur d'écran : « bouton »

Correct

<button type="button" aria-label="Menu">
  <svg aria-hidden="true" focusable="false" width="24" height="24" viewBox="0 0 24 24">…</svg>
</button>

Lecteur d'écran : « Menu, bouton »

Pourquoi. Quand le bouton reçoit le focus, le lecteur d'écran annonce en général son nom, puis son rôle. Sans nom, il ne reste que le rôle : « bouton ».


#Quand ajouter un aria-label ?

Avant d'écrire un aria-label, cherchez un texte visible, un <label> ou un alt qui puisse nommer l'élément. Si ce texte est affiché ailleurs, reliez-le avec aria-labelledby ; s'il n'existe pas, aria-label donne ce nom dans trois cas.

Bouton ou lien réduit à une icône. Le nom va sur le <button> ou le <a> lui-même, et le SVG reçoit aria-hidden="true" et focusable="false", car il ne sert que de dessin. Le bouton menu garde le nom « Menu », ouvert comme fermé : c'est aria-expanded qui dit si le menu est ouvert, avec false quand il est fermé et true quand il est ouvert.

Champ sans étiquette visible. Une étiquette <label> visible reste la meilleure solution. Si le champ n'affiche qu'un texte indicatif (le placeholder), ajoutez aria-label, car ce texte seul ne donne qu'un nom de secours.

Mais sans autre texte près du champ, une personne qui commande à la voix dira sans doute ce texte, et les WCAG peuvent alors le compter comme l'étiquette visible. Écrivez-y donc ce que fait le champ, puis reprenez-le mot pour mot dans aria-label.

Plusieurs zones du même type. Deux <nav> aux liens différents reçoivent chacune un nom différent. Une zone présente une seule fois peut s'en passer.

L'en-tête d'Atelier Pignon réunit tous ces cas.

Capture d'écran : en-tête d'Atelier Pignon avec trois liens en bandeau, une icône de menu, le champ « Rechercher dans la boutique », un bouton « Rechercher » et une icône de panier.
Dans l'en-tête d'Atelier Pignon, le menu et le panier n'affichent qu'une icône, le champ un texte indicatif : tous trois ont besoin d'un nom, donné ici par aria-label.
  • Bouton menu, une icône qui ouvre la liste des rayons : aria-label="Menu", aria-expanded="false" et le SVG masqué.
  • Champ de recherche, avec le seul texte indicatif « Rechercher dans la boutique » : aria-label="Rechercher dans la boutique".
  • Bouton de recherche, loupe et mot « Rechercher » : rien, son texte le nomme.
  • Lien du panier, une icône seule : aria-label="Panier", qui devient son intitulé.
  • Navigation du bandeau (Livraison, Retours, Contact) : aria-label="Service client".
  • Navigation ouverte par le menu (Vélos, Pièces, Accessoires, Ateliers) : aria-label="Rayons".
  • Logo texte « Atelier Pignon » dans un lien : rien.

Voici l'en-tête corrigé, à copier dans votre modèle de page.

<header>
  <nav aria-label="Service client">
    <ul>
      <li><a href="/livraison">Livraison</a></li>
      <li><a href="/retours">Retours</a></li>
      <li><a href="/contact">Contact</a></li>
    </ul>
  </nav>
 
  <button type="button" aria-label="Menu" aria-expanded="false">
    <svg aria-hidden="true" focusable="false" width="24" height="24" viewBox="0 0 24 24">…</svg>
  </button>
 
  <a href="/">Atelier Pignon</a>
 
  <form role="search" action="/recherche">
    <input type="search" name="q" aria-label="Rechercher dans la boutique"
           placeholder="Rechercher dans la boutique">
    <button type="submit">
      <svg aria-hidden="true" focusable="false" width="20" height="20" viewBox="0 0 20 20">…</svg>
      Rechercher
    </button>
  </form>
 
  <a href="/panier" aria-label="Panier">
    <svg aria-hidden="true" focusable="false" width="24" height="24" viewBox="0 0 24 24">…</svg>
  </a>
 
  <!-- Affichée par le bouton Menu -->
  <nav aria-label="Rayons" hidden>
    <ul>
      <li><a href="/velos">Vélos</a></li>
      <li><a href="/pieces">Pièces</a></li>
      <li><a href="/accessoires">Accessoires</a></li>
      <li><a href="/ateliers">Ateliers</a></li>
    </ul>
  </nav>
</header>

#Quand retirer un aria-label ?

Un aria-label est de trop sur un élément qu'ARIA interdit de nommer, comme un div ou un span sans rôle, un <p>, un <code> ou un <strong>. Les validateurs signalent l'erreur. Évitez aussi de nommer un élément de liste <li>, car les technologies d'assistance n'annoncent pas ce nom.

Un attribut role qui accepte un nom, comme role="button", rend aria-label valide. Si un élément HTML fait déjà ce travail, comme <button> ou <a>, prenez-le d'abord : c'est la première règle d'usage d'ARIA.

Il est aussi de trop sur un bouton ou un lien qui affiche un texte, car aria-label remplace ce texte. Une personne qui commande son ordinateur à la voix prononce le mot qu'elle voit, et si le nom ne contient pas ce mot, la commande échoue.

Les WCAG en font le critère 2.5.3, « Étiquette dans le nom », de niveau A, le niveau minimum. Retirez donc l'attribut, et s'il manque du contexte, faites commencer le nom par le texte visible. Sur une image ou un champ déjà nommé par alt ou <label>, aria-label ajoute de même un second texte à tenir à jour.

Sur la page des vélos cargo d'Atelier Pignon, chaque carte produit porte sur son div un aria-label qui répète son titre.

Capture d'écran : carte produit avec la photo d'un vélo cargo à caisse en bois, le titre « Vélo cargo Mistral » et le prix 2 490 €.Repère 1. Le titre « Vélo cargo Mistral », sous la photo.
Le titre « Vélo cargo Mistral »repère 1 annonce déjà le vélo : le nom posé sur le div de la carte, sans rôle, est en trop.

À éviter

<div class="carte" aria-label="Vélo cargo Mistral">
  <h3>Vélo cargo Mistral</h3>
  <p>2 490 €</p>
</div>

Correct

<div class="carte">
  <h3>Vélo cargo Mistral</h3>
  <p>2 490 €</p>
</div>

Pourquoi. Un div sans rôle ne peut pas recevoir de nom, et le titre de la carte annonce déjà le vélo à une personne qui utilise un lecteur d'écran.

Dans l'en-tête, un développeur a voulu préciser le bouton de recherche, qui affiche pourtant le mot « Rechercher ».

Capture d'écran : champ « Rechercher dans la boutique » suivi d'un bouton noir qui montre une loupe et le mot « Rechercher ».Repère 1. Le bouton à loupe qui affiche le mot « Rechercher ».
Le boutonrepère 1 affiche le mot « Rechercher » : avec aria-label « Lancer la recherche », son nom perd ce mot, et la commande vocale « Rechercher » n'atteint pas ce bouton.

À éviter

<button type="submit" aria-label="Lancer la recherche">
  <svg aria-hidden="true" focusable="false" width="20" height="20" viewBox="0 0 20 20">…</svg>
  Rechercher
</button>

Lecteur d'écran : « Lancer la recherche, bouton »

Correct

<button type="submit">
  <svg aria-hidden="true" focusable="false" width="20" height="20" viewBox="0 0 20 20">…</svg>
  Rechercher
</button>

Lecteur d'écran : « Rechercher, bouton »

Pourquoi. Le nom du bouton devient « Lancer la recherche » et perd le mot « Rechercher ». Une personne qui dit « Rechercher » à sa commande vocale n'atteint donc pas le bouton.


#Quoi écrire dans un aria-label

Un bon aria-label dit ce que fait l'élément, en un à trois mots le plus souvent. Quand l'élément affiche un texte, partez de ce texte et ajoutez les précisions après lui.

N'écrivez pas le rôle dans le nom, car le lecteur d'écran le dit déjà. Une navigation nommée « Navigation service client » ferait ainsi entendre le mot deux fois.

Quand la même action revient plusieurs fois dans la page, donnez à chaque élément un nom différent, en mettant les mots importants en premier. Pour une action, c'est souvent le verbe, puis l'objet qui distingue l'élément de ses voisins. Pour une série de liens « En savoir plus » sur des cartes, un texte masqué dans le lien le fait sans aria-label.

Traduisez les valeurs avec le reste de l'interface, comme le demande le guide de nommage du W3C. Dans les tests d'Adrian Roselli de juillet 2025, aucun des quatre navigateurs testés n'a traduit automatiquement un aria-label dynamique, c'est-à-dire modifié après le chargement de la page.

Chrome, Edge et Firefox n'ont pas traduit non plus un contenu caché au chargement puis affiché, comme la navigation « Rayons ». C'est pourquoi les valeurs se rangent dans vos fichiers de traduction, à côté du texte visible.

Capture d'écran : quatre éléments d'Atelier Pignon : le lien « Voir » d'une carte produit, le bouton menu, les trois corbeilles du panier et l'icône du panier dans l'en-tête anglais.Repère 1. Le lien « Voir » de la carte produit. Repère 2. Le bouton menu de l'en-tête. Repère 3. Les trois corbeilles identiques du panier. Repère 4. L'icône du panier dans l'en-tête anglais.
Quatre éléments à nommer : le lien « Voir »repère 1, le bouton menurepère 2, trois corbeilles identiquesrepère 3 et le panier du site anglaisrepère 4.
Une bonne valeur d'aria-label reprend le mot affiché ou l'action, ajoute l'objet quand l'action se répète et suit la langue de la page.
Règle À éviter Correct
repère 1 Le texte visible en tête : lien « Voir » d'une carte produit"Fiche du vélo cargo Mistral""Voir le vélo cargo Mistral"
repère 2 À quoi il sert, sans son aspect ni son rôle : bouton menu"Bouton hamburger""Menu"
repère 3 Un nom unique pour une action répétée : trois corbeilles dans le panier"Retirer"
"Retirer"
"Retirer"
"Retirer l'antivol"
"Retirer la sacoche"
"Retirer la pompe"
repère 4 La langue de la page : version anglaise du site"Panier""Cart"

#Pourquoi un aria-label est ignoré ?

Un aria-label peut être écrasé par aria-labelledby, ignoré quand il est vide, ou rendu inutile par le rôle de l'élément ou par aria-hidden. L'attribut est alors bien dans le HTML, et pourtant l'onglet Accessibility affiche un autre nom, ou aucun.

Ces cinq causes d'un aria-label ignoré se réparent en retirant ou en remplissant un attribut ; avec aria-hidden, l'élément disparaît même pour les lecteurs d'écran, nom compris.
Ce qui se passeNom finalQue faire
L'élément porte aussi aria-labelledby, qui pointe vers un id existantLe texte visé. Si l'id n'existe pas ou si ce texte est vide, aria-label sert de nomGardez un seul des deux attributs
aria-label="", ou une valeur faite d'espacesAttribut ignoré : le nom vient de la source suivante (<label>, alt, contenu), ou reste videN'écrivez l'attribut que si la valeur existe
aria-hidden="true" sur l'élément ou sur un parentAucun : l'élément disparaît pour les outils d'aide, avec son nomRetirez aria-hidden de tout élément qui peut recevoir le focus, et de ses parents
Un rôle qui interdit le nom : div ou span sans rôle, pVideRetirez l'attribut, ou nommez le bouton ou le lien concerné
role="presentation" et aria-label sur le même élément, une combinaison qu'ARIA interditCelui d'aria-label si le rôle d'origine accepte un nom : le navigateur ignore role="presentation" et l'élément garde son rôleRetirez l'un des deux, selon que l'élément doit être masqué ou nommé

Dans un modèle de page, une variable vide donne aria-label="" sans rien changer à l'écran, comme sur cette corbeille du panier d'Atelier Pignon, et le navigateur ignore alors l'attribut. Vérifiez donc que la variable n'est pas vide avant d'écrire aria-label.

Capture d'écran : ligne du panier pour un antivol à 39 €, terminée par un bouton marqué d'une corbeille, sans texte.Repère 1. La corbeille au bout de la ligne de l'antivol, sans texte.
La corbeillerepère 1 n'affiche aucun texte : avec un aria-label vide, le lecteur d'écran n'annonce que « bouton » ; avec « Retirer l'antivol », il dit ce qu'elle retire.

À éviter

<button type="button" aria-label="">
  <svg aria-hidden="true" focusable="false" width="20" height="20" viewBox="0 0 24 24">…</svg>
</button>

Lecteur d'écran : « bouton »

Correct

<button type="button" aria-label="Retirer l'antivol">
  <svg aria-hidden="true" focusable="false" width="20" height="20" viewBox="0 0 24 24">…</svg>
</button>

Lecteur d'écran : « Retirer l'antivol, bouton »


#Comment vérifier qu'un aria-label fonctionne ?

Vérifiez le nom en deux temps : lisez-le dans les outils de développement du navigateur, puis écoutez-le avec un lecteur d'écran. Dans Chrome, sélectionnez l'élément dans le panneau Elements, ouvrez l'onglet Accessibility et lisez la ligne Name, sous Computed Properties.

L'option « Show accessibility tree » montre la page telle que la reçoivent les outils d'aide. Dans Firefox, l'inspecteur d'accessibilité affiche le même nom, ou null quand l'élément n'en a pas.

Capture d'écran : bouton menu d'Atelier Pignon, un carré noir marqué de trois traits, à côté du logo.Repère 1. Le bouton menu, à gauche du logo.
Le bouton menurepère 1 ne montre que trois traits, sans texte : dans l'onglet Accessibility de Chrome, sa ligne Name doit afficher « Menu », la valeur de son aria-label.

Passez ensuite trente secondes au lecteur d'écran : sous Windows, installez NVDA, qui est gratuit ; sur Mac, VoiceOver est intégré et se lance avec Commande+F5, et NVDA s'y écoute dans une machine virtuelle Windows. Parcourez l'en-tête avec la touche Tab, et chaque élément s'annoncera en général par son nom puis son rôle, par exemple « Panier, lien ».

Les tests automatiques fondés sur axe-core signalent un nom manquant avec les règles button-name, link-name et label. Un div nommé apparaît sous aria-prohibited-attr : en erreur s'il est vide, à vérifier s'il contient du texte. La règle label-content-name-mismatch repère un nom qui ne contient pas le texte visible, et elle est active par défaut depuis axe-core 4.14.0.

Sur le site de l'Atelier Pignon, un scan avec Includdy signale le bouton menu de l'en-tête, qui n'a pas de nom. Includdy propose aussi un correctif de code qui lui en donne un, à relire avant de l'intégrer.

Avant de livrer l'en-tête :


Si votre en-tête est déjà en ligne, commencez par le passer au scan d'Includdy : vous saurez quels éléments n'ont pas de nom, et Includdy proposera pour chacun un correctif à relire. Cochez ensuite les sept points de la liste avant de livrer.


Partagez cet article

Questions fréquentes

Non. Les WCAG demandent que chaque bouton, lien ou champ ait un nom lisible par les lecteurs d'écran (critère 4.1.2, de niveau A). aria-label n'est qu'une des façons de le donner.

Préférez le texte visible, l'élément <label> ou l'attribut alt. aria-label sert quand l'élément n'affiche aucun texte capable de le nommer.

aria-label donne le nom de l'élément, ce qu'il est ou ce qu'il fait. aria-describedby y ajoute une description. Les lecteurs d'écran l'annoncent en général en dernier, après le nom, le rôle et l'état.

La description ne fait pas partie du nom. Elle sert aux consignes et aux précisions, comme le format attendu d'un mot de passe, écrites dans un texte visible de la page.

alt. C'est l'attribut que le HTML prévoit pour l'image. Un aria-label ajouté en plus prendrait sa place comme nom.

Le guide du texte alternatif détaille quoi écrire selon le rôle de l'image : décorative, informative ou seule dans un lien.

Les deux nomment un bouton icône : choisissez l'un des deux. Sur un bouton qui porte les deux, aria-label l'emporte et le texte masqué n'est jamais lu.

Pour masquer le texte, reprenez la classe de la technique C7 du W3C, qui le place dans une boîte de 1 px. Avec display: none, les lecteurs d'écran ne le trouveraient plus.

Un à trois mots suffisent pour la plupart des éléments, selon le guide de nommage du W3C. Ajoutez un mot quand il distingue l'élément d'un voisin.

Les consignes et les explications vont dans un texte visible, relié à l'élément par aria-describedby.

Exactement comme en HTML, avec le tiret : aria-label. React garde le nom HTML de tous les attributs aria-* et data-*. La plupart des autres attributs s'écrivent en camelCase.