Votre site web est-il accessible ?Vérifier gratuitement
WCAG 4.1.2Niveau ARobuste

aria-label : comment nommer correctement les éléments

Autres noms: Attribut aria-label, Étiquette ARIA, Étiquette invisible

Définition

aria-label est un attribut ARIA qui définit le nom accessible d’un élément sous forme de chaîne de texte. Les lecteurs d’écran annoncent ce nom à la place du contenu de l’élément ; on l’utilise donc surtout pour les éléments interactifs sans texte visible, comme les boutons icônes.

aria-label est un attribut HTML issu de la spécification ARIA qui donne à un élément un nom accessible sous forme de texte brut. Un lecteur d’écran l’annonce, par exemple « Fermer la boîte de dialogue, bouton » pour une icône « × ». C’est la solution la plus rapide pour les éléments interactifs sans texte visible, et l’un des attributs les plus mal utilisés lorsqu’un texte visible existe déjà.

Ce que cela signifie

Le critère WCAG 4.1.2 Nom, rôle et valeur (niveau A, WCAG 2.2) exige que chaque composant d’interface utilisateur ait un nom pouvant être déterminé par un programme informatique. Le W3C cite comme technique suffisante pour y satisfaire la technique ARIA14, qui consiste à utiliser aria-label pour fournir un nom accessible lorsqu’une étiquette visible ne peut pas être utilisée. La formulation compte : aria-label est prévu pour les cas où une étiquette visible n’est pas possible.

Trois choses à savoir sur cet attribut :

Fait Conséquence
Il remplace le texte propre de l’élément <a aria-label="Read more">Shipping terms</a> est annoncé « Read more » : le texte visible est ignoré
aria-labelledby l’emporte sur lui Si les deux sont définis, c’est le texte référencé qui devient le nom
Il est invisible Les utilisateurs voyants ne le voient jamais, les erreurs passent donc inaperçues

Il fonctionne sur les éléments interactifs (liens, boutons, champs de formulaire), sur les repères comme <nav> et sur role="img". Sur une simple div ou un simple span sans rôle, ARIA n’autorise pas de nom : de nombreux lecteurs d’écran y ignorent l’étiquette.

Exemples

Exemple
<!-- Good: icon-only button -->
<button aria-label="Close dialog">
  <svg aria-hidden="true">…</svg>
</button>

<!-- Good: two navigations told apart -->
<nav aria-label="Main">…</nav>
<nav aria-label="Footer">…</nav>

<!-- Bad: label contradicts visible text -->
<a href="/shipping" aria-label="Click here">Shipping terms</a>
À faire

Utilisez aria-label pour les boutons icônes, pour les champs de recherche sans étiquette visible et pour distinguer plusieurs repères ARIA du même type. Décrivez l’action (« Ouvrir le menu »), pas l’icône (« Hamburger »). Masquez l’icône elle-même avec aria-hidden="true".

À éviter

Ajouter aria-label sur des éléments qui ont déjà un bon texte visible, l’utiliser sur une simple div ou un span, le bourrer de mots-clés pour le référencement, ou l’utiliser à la place d’un vrai <label> sur des champs de formulaire qui ont la place d’en afficher un.

Comment vérifier aria-label

    Questions fréquentes

    Quelle est la différence entre aria-label et aria-labelledby ?

    aria-label contient le nom sous forme de texte dans l’attribut lui-même. aria-labelledby pointe vers l’id d’un autre élément dont le texte visible devient le nom. Utilisez aria-labelledby lorsque le texte figure déjà sur la page.

    aria-label remplace-t-il le texte visible d’un lien ?

    Oui. Pour les technologies d’assistance, aria-label remplace le contenu de l’élément. C’est pourquoi une étiquette différente du texte visible déroute les utilisateurs de lecteurs d’écran et de la commande vocale.

    aria-label est-il utile pour le référencement (SEO) ?

    Non. aria-label est destiné aux technologies d’assistance. Des mots-clés cachés rendent la page plus difficile à utiliser et n’ont rien à y faire.

    Peut-on utiliser aria-label sur une div ?

    Seulement si la div a un rôle qui autorise un nom, comme role="region" ou role="img". Sur une div ou un span générique sans rôle, ARIA interdit de nommer l’élément et de nombreux lecteurs d’écran ignorent l’étiquette.

    Comment trouver les icônes sans nom sur mon site ?

    Le vérificateur WCAG gratuit contrôle votre page d’accueil selon les WCAG 2.2 AA, y compris les liens et les boutons sans nom accessible.

    • Nom accessible : définition et mode de calcul

      Le nom accessible est le texte que le navigateur transmet aux technologies d’assistance pour identifier un élément, par exemple les mots qu’un lecteur d’écran annonce pour un bouton, un lien ou un champ de formulaire. Le critère WCAG 4.1.2 exige un nom déterminable par un programme informatique pour chaque composant d’interface utilisateur.

      Lire la définition: Nom accessible : définition et mode de calcul
    • ARIA (WAI-ARIA) : rôles, états et propriétés expliqués

      ARIA (WAI-ARIA, Accessible Rich Internet Applications) est une spécification du W3C qui définit des attributs HTML (rôles, états et propriétés) indiquant aux technologies d’assistance ce qu’est un élément personnalisé, quel est son nom et dans quel état il se trouve.

      Lire la définition: ARIA (WAI-ARIA) : rôles, états et propriétés expliqués
    • Bouton icône : comment lui donner un nom accessible

      Un bouton icône est un bouton qui n’affiche qu’un symbole (une loupe, une croix, trois traits) sans aucun texte visible. Pour être accessible, il a besoin d’un nom accessible dans le code, qui indique aux technologies d’assistance ce que fait le bouton.

      Lire la définition: Bouton icône : comment lui donner un nom accessible
    • Bouton vide : comprendre et corriger l’erreur

      Un bouton vide est un élément bouton sans nom accessible : ni texte, ni aria-label, ni texte alternatif sur une image qu’il contient. Les lecteurs d’écran annoncent seulement qu’il s’agit d’un bouton, pas ce qu’il fait.

      Lire la définition: Bouton vide : comprendre et corriger l’erreur

    Confiez l’accessibilité de votre site web à l’IA

    Conçu en Europe. Installation en 2 minutes, sans développeur. Mettez l’accessibilité de votre site web en pilote automatique grâce aux corrections par IA et à la surveillance automatisée.

    1. 1Choisir votre offre
    2. 2Installation en 2 min
    3. 3L’IA corrige votre site
    4. Terminé