SVG accessible : texte alternatif des icônes et logos
Autres noms: Icônes SVG accessibles, Texte alternatif d’un SVG, Accessibilité des SVG inline
Définition
Un SVG accessible est un graphique vectoriel que les technologies d’assistance savent traiter correctement : un SVG porteur de sens reçoit role="img" et une alternative textuelle, un SVG décoratif est masqué avec aria-hidden="true", et une icône placée dans un lien ou un bouton laisse le nom à son élément de commande. Les SVG sont des contenus non textuels au sens du critère WCAG 1.1.1, de niveau A.
Un SVG accessible, c’est un graphique vectoriel traité comme une image : il reçoit une alternative textuelle quand il a un sens, et le silence quand il n’en a pas. Les logos, icônes, illustrations et graphiques simples sont souvent des SVG inline, intégrés directement au HTML. Sans balisage supplémentaire, les lecteurs d’écran les ignorent, annoncent « image » sans aucun nom, ou lisent un fouillis de données de tracé. Quelques attributs font toute la différence.
Ce que cela signifie
Tout SVG est un contenu non textuel au sens du critère WCAG 1.1.1 Contenu non textuel (niveau A) : tout contenu non textuel présenté à l’utilisateur doit avoir une alternative textuelle remplissant une fonction équivalente. Les exceptions comptent aussi pour les SVG : les éléments de commande ont besoin d’un nom qui décrit leur fonction, et la décoration doit être réalisée de façon que les technologies d’assistance puissent l’ignorer. Les règles de test du W3C vérifient qu’un élément SVG doté d’un rôle explicite a un nom accessible non vide.
En pratique, il y a quatre cas :
| Le SVG est… | Que faire | Technique du W3C |
|---|---|---|
| Un graphique ou un logo porteur de sens | role="img" plus aria-label, ou aria-labelledby pointant vers son <title> |
ARIA6, ARIA10 |
| Décoratif (fioriture, forme d’arrière-plan) | aria-hidden="true" et aucun role |
Exception pour la décoration |
| Une icône dans un lien ou un bouton | Masquer le SVG et nommer l’élément de commande | Exception pour les éléments de commande, voir 4.1.2 |
| Un graphique de données ou un schéma | Nom court plus description longue ou tableau de données | G95, ARIA15, G74 |
Un <img src="logo.svg"> fonctionne comme n’importe quelle autre image et prend un attribut alt (voir texte alternatif). La difficulté vient du <svg> inline, car les navigateurs ne le traitent pas comme une image par défaut.
Exemples
<!-- Meaningful graphic -->
<svg role="img" aria-labelledby="award-title" viewBox="0 0 64 64">
<title id="award-title">Winner of the 2026 Design Award</title>
<path d="…" />
</svg>
<!-- Decorative wave -->
<svg aria-hidden="true" focusable="false" viewBox="0 0 400 40">
<path d="…" />
</svg>
<!-- Icon in a button: the button carries the name -->
<button type="button" aria-label="Search">
<svg aria-hidden="true" focusable="false" viewBox="0 0 24 24"><path d="…" /></svg>
</button>Le badge de récompense est annoncé comme une image avec son nom. La vague est invisible pour les lecteurs d’écran, comme les autres images décoratives. Dans le bouton de recherche, le SVG reste silencieux et l’aria-label devient le nom accessible du bouton. Sans lui, vous auriez un bouton icône qui ne dit rien. focusable="false" évite que d’anciens navigateurs placent le SVG dans l’ordre de tabulation.
Décider pour chaque SVG s’il porte du sens, ajouter role="img" et un nom court à ceux qui en portent, masquer les décoratifs avec aria-hidden="true", nommer l’élément de commande plutôt que l’icône, et vérifier que les couleurs des icônes respectent aussi le contraste du contenu non textuel.
Se fier au seul <title>, mettre un aria-label sur un SVG sans rôle, donner à une icône et à son bouton deux noms différents, laisser des SVG décoratifs exposés, ou utiliser un SVG de texte à la place d’un vrai texte.
Comment vérifier un SVG accessible
Questions fréquentes
Comment ajouter un texte alternatif à un SVG ?
Pour <img src="file.svg">, utilisez l’attribut alt comme pour toute image. Pour un <svg> inline, ajoutez role="img" et soit aria-label="…", soit aria-labelledby pointant vers un <title> placé dans le SVG.
Faut-il mettre aria-hidden sur les icônes SVG ?
Oui, quand l’icône se trouve à côté d’un texte visible, ou dans un lien ou un bouton qui a déjà un nom. L’icône est alors masquée avec aria-hidden="true" et c’est l’élément de commande qui porte le nom. Une icône isolée qui transmet une information a besoin de son propre nom.
Un logo SVG a-t-il besoin d’un texte alternatif ?
Oui, un logo est porteur de sens, en général le nom de l’entreprise. Si le logo est aussi le lien vers la page d’accueil, nommez le lien, par exemple « Boulangerie Dupont, accueil », et masquez le SVG qu’il contient.
Comment rendre accessible un graphique SVG ?
Donnez-lui un nom court avec role="img" et fournissez toute l’information sous forme de texte, avec une description à côté ou un tableau de données. Le W3C parle d’alternative textuelle courte et d’alternative textuelle longue.
À quoi sert focusable="false" sur un SVG ?
Cet attribut empêche certains anciens navigateurs de placer le SVG dans l’ordre de tabulation. Les navigateurs récents n’en ont pas besoin, mais il ne gêne pas sur les SVG décoratifs et les icônes.
Termes associés
Texte 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 alternatifImages décoratives : quand alt="" est le bon choix
Les images décoratives sont des images purement décoratives ou utilisées uniquement pour la mise en forme, qui n’apportent aucune information à la page. Le critère WCAG 1.1.1 exige qu’elles soient intégrées de façon que les technologies d’assistance puissent les ignorer, par exemple avec un attribut alt vide ou en arrière-plan CSS.
Lire la définition: Images décoratives : quand alt="" est le bon choixBouton 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 accessibleNom 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