# SVG accessible : texte alternatif des icônes et logos

Source: https://allyway.ai/fr/glossary/svg-accessible

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](https://www.w3.org/WAI/WCAG22/Understanding/non-text-content.html) (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](https://allyway.ai/fr/glossary/texte-alternatif)). La difficulté vient du `<svg>` inline, car les navigateurs ne le traitent pas comme une image par défaut.

> **Note:** > **Le `<title>` seul ne suffit pas**
> Un `<title>` dans un SVG s’affiche souvent comme infobulle, mais les lecteurs d’écran le lisent de façon inconstante. Associez-le à `role="img"` et à `aria-labelledby` pointant vers l’`id` du titre.

## Exemples

```html title="Exemple"
<!-- 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](https://allyway.ai/fr/glossary/images-decoratives). Dans le bouton de recherche, le SVG reste silencieux et l’`aria-label` devient le [nom accessible](https://allyway.ai/fr/glossary/nom-accessible) du bouton. Sans lui, vous auriez un [bouton icône](https://allyway.ai/fr/glossary/bouton-icone) qui ne dit rien. `focusable="false"` évite que d’anciens navigateurs placent le SVG dans l’ordre de tabulation.

**Do:** À faire

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](https://allyway.ai/fr/glossary/contraste-du-contenu-non-textuel).

**Don't:** À éviter

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

Q: Comment ajouter un texte alternatif à un SVG ?
A: 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.

Q: Faut-il mettre aria-hidden sur les icônes SVG ?
A: 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.

Q: Un logo SVG a-t-il besoin d’un texte alternatif ?
A: 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.

Q: Comment rendre accessible un graphique SVG ?
A: 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.

Q: À quoi sert focusable="false" sur un SVG ?
A: 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.
