# Bouton icône : comment lui donner un nom accessible

Source: https://allyway.ai/fr/glossary/bouton-icone

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.

Un bouton icône est un bouton qui affiche un symbole au lieu d’un mot : la loupe qui ouvre la recherche, le « × » qui ferme une boîte de dialogue, le cœur qui enregistre un produit. Les boutons à icône seule font gagner de la place, mais le symbole est invisible pour un lecteur d’écran : le bouton a besoin, dans le code, d’un nom qui dit ce qu’il fait.

## Ce que cela signifie

[WCAG 4.1.2 Nom, rôle et valeur](https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html) est un critère de niveau A des [WCAG 2.2](https://allyway.ai/fr/regulations/wcag-2-2). Pour chaque composant d’interface utilisateur, le nom et le rôle doivent pouvoir être déterminés par un programme informatique. Un `<button>` natif apporte le rôle. Le nom, c’est à vous de le fournir, et une icône seule n’en donne pas. Quand il manque, les outils d’analyse signalent un [bouton vide](https://allyway.ai/fr/glossary/bouton-vide), et le W3C le classe comme cas d’échec F68 : un composant sans nom déterminé par un programme informatique.

Le W3C distingue deux notions. Une *étiquette* est visible par tous ; un *nom* est ce que lisent les logiciels, et il peut être masqué. Les commandes à icône sont le cas typique d’un nom sans étiquette visible. C’est pourquoi un même bouton pictogramme peut être conforme ou non conforme selon un seul attribut.

Il existe quatre méthodes fiables pour donner un nom à une commande à icône :

| Technique | Code | Idéal pour |
|---|---|---|
| `aria-label` (ARIA14) | `<button aria-label="Search">` | La plupart des boutons icônes |
| Texte masqué visuellement | texte avec une classe `sr-only` dans le bouton | Un texte qui doit aussi bien se traduire |
| `aria-labelledby` (ARIA16) | pointe vers l’`id` d’un texte visible | Les boutons placés à côté d’un titre ou d’une étiquette existants |
| Image avec texte alternatif | `<img src="search.svg" alt="Search">` | Les boutons qui contiennent un élément `<img>` |

> **Tip:** > **Décrivez l’action, pas l’image**
> « Fermer la boîte de dialogue » aide ; « X » ou « icône croix », non. Si l’icône change l’état de quelque chose, gardez un nom stable et exposez l’état, par exemple avec `aria-pressed="true"` sur un bouton « Couper le son ».

Les personnes qui utilisent la commande vocale disent ce qu’elles voient, par exemple « cliquer sur rechercher ». Choisissez des noms qui correspondent au sens habituel de l’icône, pour que la commande prononcée fonctionne. Une [infobulle au survol](https://allyway.ai/fr/glossary/contenu-au-survol-ou-au-focus) est un plus pour les utilisateurs voyants qui naviguent à la souris, mais ce n’est pas le nom accessible.

## Exemples

```html title="Exemple"
<!-- Icon button without a name: announced only as "button" -->
<button class="cart"><svg viewBox="0 0 24 24">…</svg></button>

<!-- Fixed with aria-label; the decorative SVG is hidden -->
<button class="cart" aria-label="Open cart">
  <svg viewBox="0 0 24 24" aria-hidden="true" focusable="false">…</svg>
</button>

<!-- Fixed with visually hidden text -->
<button class="menu">
  <svg aria-hidden="true">…</svg>
  <span class="sr-only">Open menu</span>
</button>
```

Quand l’icône est un élément `<img>`, son texte alternatif devient le nom du bouton. Un [attribut alt manquant](https://allyway.ai/fr/glossary/attribut-alt-manquant) sur cette image laisse donc le bouton sans nom ; il en va de même pour les liens à icône, qui apparaissent alors comme un [lien vide](https://allyway.ai/fr/glossary/lien-vide).

**Do:** À faire

Utilisez un vrai `<button>`, donnez-lui un nom d’action court, masquez le SVG ou la police d’icônes avec `aria-hidden="true"`, et utilisez le même nom pour la même action sur tout le site.

**Don't:** À éviter

Placer l’icône sur une `div` cliquable, compter sur `title` ou sur une infobulle au survol comme seul nom, ou laisser un glyphe de police d’icônes être lu comme un caractère quelconque.

## Comment vérifier un bouton icône



## Questions fréquentes

Q: Qu’est-ce qu’un bouton icône en accessibilité ?
A: Un bouton qui n’affiche qu’un symbole, sans texte visible. Il est accessible s’il a un nom accessible dans le code, par exemple via `aria-label` ou un texte masqué visuellement, qui décrit l’action.

Q: Faut-il utiliser aria-label ou un texte masqué pour un bouton icône ?
A: Les deux sont valables. `aria-label` est rapide et couvert par la technique ARIA14. Le texte masqué visuellement est un texte normal de la page : il est donc pris en compte de façon plus fiable par les outils de traduction. Choisissez une approche et appliquez-la de façon cohérente.

Q: Le SVG d’un bouton icône doit-il avoir un titre ?
A: Pas si le bouton a déjà un nom. Masquez le SVG avec `aria-hidden="true"`, sinon certains lecteurs d’écran annoncent aussi le graphique et le nom risque d’être lu deux fois.

Q: Comment trouver les boutons icônes sans nom sur mon site ?
A: Lancez le [vérificateur WCAG gratuit](https://allyway.ai/fr/free-wcag-accessibility-scanner-for-websites) sur vos pages clés. Il signale les boutons et les liens sans nom accessible : vous voyez toutes les icônes sans intitulé dans une seule liste.

Q: allyWay peut-il corriger automatiquement les boutons icônes ?
A: Oui. allyWay détecte les boutons icônes sans nom sur l’ensemble de votre site et leur donne des noms clairs, lus à voix haute par les lecteurs d’écran et rédigés par l’IA à partir du contenu de vos pages. Les [corrections automatiques](https://allyway.ai/fr/automatic-accessibility-fixes-for-website) sont appliquées par le script allyWay, sans modifier votre thème ni votre code, et chaque correction est annulable en un clic. [Commencez gratuitement](https://app.allyway.ai/register) et découvrez quelles icônes allyWay nomme sur votre site.
