Bouton icône : comment lui donner un nom accessible
Autres noms: Bouton à icône seule, Commande à icône, Bouton pictogramme
Définition
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 est un critère de niveau A des 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, 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> |
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 est un plus pour les utilisateurs voyants qui naviguent à la souris, mais ce n’est pas le nom accessible.
Exemples
<!-- 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 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.
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.
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
Qu’est-ce qu’un bouton icône en accessibilité ?
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.
Faut-il utiliser aria-label ou un texte masqué pour un bouton icône ?
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.
Le SVG d’un bouton icône doit-il avoir un titre ?
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.
Comment trouver les boutons icônes sans nom sur mon site ?
Lancez le vérificateur WCAG gratuit 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.
allyWay peut-il corriger automatiquement les boutons icônes ?
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 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 et découvrez quelles icônes allyWay nomme sur votre site.
Termes associés
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’erreurLien vide : comprendre et corriger l’erreur
Un lien vide est un élément de lien sans nom accessible : pas de texte, pas de texte alternatif sur une image qu’il contient et pas d’aria-label. Les lecteurs d’écran ne peuvent l’annoncer que comme un simple lien, et l’utilisateur ne sait pas où il mène.
Lire la définition: Lien vide : comprendre et corriger l’erreurAttribut alt manquant : l’erreur expliquée et corrigée
Un attribut alt manquant signifie qu’un élément img (ou un bouton image, ou une zone de carte image) n’a aucun attribut alt. Les technologies d’assistance ne peuvent pas savoir si l’image est informative ou décorative et risquent de lire le nom du fichier à la place.
Lire la définition: Attribut alt manquant : l’erreur expliquée et corrigéeTexte alternatif
Le texte alternatif est une courte description écrite d’une image. Les lecteurs d’écran la lisent à voix haute et les navigateurs l’affichent quand l’image ne se charge pas : les personnes qui ne peuvent pas voir l’image en saisissent ainsi le sens.
Lire la définition: Texte alternatif