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

Source: https://allyway.ai/fr/glossary/aria-label

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](https://allyway.ai/fr/glossary/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](https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html) (niveau A, [WCAG 2.2](https://allyway.ai/fr/regulations/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.

> **Tip:** > **Les mots visibles d’abord**
> Si un élément interactif affiche du texte, l’aria-label doit commencer exactement par ces mots (« Rechercher des produits » pour un bouton qui affiche « Rechercher »). Le critère 2.5.3 [Étiquette dans le nom](https://allyway.ai/fr/glossary/etiquette-dans-le-nom) du W3C exige que le nom contienne le texte visible et recommande de le placer en premier, afin que les utilisateurs de la commande vocale puissent prononcer ce qu’ils voient.

## Exemples

```html title="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>
```

**Do:** À faire

Utilisez aria-label pour les [boutons icônes](https://allyway.ai/fr/glossary/bouton-icone), pour les champs de recherche sans étiquette visible et pour distinguer plusieurs [repères ARIA](https://allyway.ai/fr/glossary/reperes-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"`.

**Don't:** À é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

Q: Quelle est la différence entre aria-label et aria-labelledby ?
A: 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.

Q: aria-label remplace-t-il le texte visible d’un lien ?
A: 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.

Q: aria-label est-il utile pour le référencement (SEO) ?
A: 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.

Q: Peut-on utiliser aria-label sur une div ?
A: 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.

Q: Comment trouver les icônes sans nom sur mon site ?
A: Le [vérificateur WCAG gratuit](https://allyway.ai/fr/free-wcag-accessibility-scanner-for-websites) contrôle votre page d’accueil selon les WCAG 2.2 AA, y compris les liens et les boutons sans nom accessible.
