# Bouton vide : comprendre et corriger l’erreur

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

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.

Un bouton vide est un bouton qui n’a pas de [nom accessible](https://allyway.ai/fr/glossary/nom-accessible) : un lecteur d’écran ne peut donc pas dire ce qu’il fait. Les outils d’analyse le signalent comme « Bouton vide » (« Empty button ») ou « Le bouton n’a pas de nom accessible » (« Button has no accessible name »). Les suspects habituels sont les [boutons composés d’une seule icône](https://allyway.ai/fr/glossary/bouton-icone) : la loupe de recherche, le menu hamburger, la croix « × » qui ferme une fenêtre pop-up et les flèches d’un carrousel.

## Ce que cela signifie

Les utilisateurs voyants comprennent la fonction d’un bouton grâce à son icône. Un lecteur d’écran, lui, a besoin de texte. Sans nom, il annonce simplement « bouton », et l’utilisateur doit l’activer pour savoir ce qui se passe, ce qui peut aussi bien être « supprimer » que « suivant ». Les personnes qui utilisent la commande vocale ont le même problème : elles ne peuvent pas dire « cliquer sur Rechercher » si le bouton n’a aucun nom correspondant.

Le critère [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). Il exige que le nom et le rôle de chaque composant d’interface utilisateur puissent être déterminés par un programme informatique. Un `<button>` natif a déjà le bon rôle : il n’échoue que s’il n’a pas de nom. Le W3C répertorie ce cas comme cas d’échec F68 : un composant sans nom déterminé par un programme informatique. Le nom peut être visible ou invisible, mais le W3C précise que, dans bien des cas, l’étiquette visible et le nom devraient être identiques.

| Contenu du bouton | Source du nom | Résultat |
|---|---|---|
| `<button>Search</button>` | Texte dans le bouton | Réussi |
| Icône + `aria-label="Search"` | aria-label | Réussi |
| `<img alt="Search">` à l’intérieur | Texte alternatif de l’image | Réussi |
| Icône seule, sans nom | – | **Bouton vide** |
| `<img>` sans alt, ou `alt=""` | – | **Bouton vide** |

> **Note:** > **La même erreur, sur un autre élément**
> Un [lien vide](https://allyway.ai/fr/glossary/lien-vide) et un bouton vide ont la même cause et la même correction. La différence : un lien vous emmène ailleurs, un bouton déclenche une action sur la page.

## Exemples

```html title="Exemple"
<!-- Empty button: icon only -->
<button class="close"><svg aria-hidden="true">…</svg></button>

<!-- Fixed: accessible name with aria-label -->
<button class="close" aria-label="Close dialog"><svg aria-hidden="true">…</svg></button>

<!-- Fixed: image with alt text -->
<button type="submit"><img src="search.svg" alt="Search"></button>
```

Une image utilisée comme contenu d’un bouton a besoin d’un équivalent textuel : un [attribut alt manquant](https://allyway.ai/fr/glossary/attribut-alt-manquant) sur cette image produit donc lui aussi un bouton vide.

**Do:** À faire

Nommez l’action en un ou deux mots : « Rechercher », « Ouvrir le menu », « Fermer la boîte de dialogue », « Diapositive suivante ». Dans un bouton nommé, masquez les icônes décoratives avec `aria-hidden="true"`.

**Don't:** À éviter

N’utilisez pas une `div` ou un `span` mis en forme comme un bouton, sans rôle ni nom, ne comptez pas uniquement sur une infobulle ou sur `title`, et ne donnez pas le même nom à tous les boutons icônes (« bouton », « icône »).

## Comment corriger un bouton vide



Les widgets de thème et les constructeurs de pages produisent souvent des boutons vides. Si vous utilisez [Shopify](https://allyway.ai/fr/integrations/shopify-accessibility-integration), vérifiez d’abord les commandes du panier, de la recherche et des carrousels.

## Questions fréquentes

Q: Qu’est-ce qu’un bouton vide ?
A: Un bouton sans nom accessible. Les lecteurs d’écran annoncent « bouton », mais pas ce que fait le bouton.

Q: L’attribut aria-label suffit-il à corriger un bouton vide ?
A: Oui : pour les boutons composés d’une seule icône, `aria-label` est une technique suffisante (ARIA14). Si le bouton affiche un texte visible, le nom doit contenir ce texte, pour que les personnes qui utilisent la commande vocale puissent dire ce qu’elles voient.

Q: Un attribut title compte-t-il comme nom de bouton ?
A: Les navigateurs peuvent utiliser `title` comme nom en dernier recours, mais ce n’est pas une bonne correction : il ne s’affiche ni sur les appareils tactiles ni pour les utilisateurs du clavier. Préférez `aria-label` ou un texte visible.

Q: Comment trouver les boutons vides sur mon site ?
A: Lancez le [vérificateur WCAG gratuit](https://allyway.ai/fr/free-wcag-accessibility-scanner-for-websites) sur votre page d’accueil. Il signale les boutons vides ainsi que les problèmes associés, comme une [étiquette de formulaire manquante](https://allyway.ai/fr/glossary/etiquette-de-formulaire-manquante).

Q: allyWay peut-il corriger automatiquement les boutons vides ?
A: Oui. allyWay détecte les boutons sans intitulé sur l’ensemble de votre site et leur donne des noms clairs que les lecteurs d’écran peuvent lire à voix haute, 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 modification de votre thème ni de votre code, et chaque correction est annulable en un clic. [Commencez gratuitement](https://app.allyway.ai/register) et découvrez quels boutons allyWay nomme sur votre site.
