Free scan

Fix "SVG image without text alternative" in HTML

Why it's a problem

An <svg role="img"> is announced as an image. With no <title> and no aria-label the screen reader has nothing to say: a logo, a chart or an action icon becomes an anonymous image.

How to fix it — HTML

Add a <title> as the SVG's first child and reference it with aria-labelledby (support for <title> alone varies between screen readers), or put aria-label on the <svg>. A purely decorative SVG gets aria-hidden="true" and no role="img".

Avoid
<svg role="img" viewBox="0 0 24 24">
  <path d="…"/>
</svg>
Correct
<svg role="img" viewBox="0 0 24 24" aria-labelledby="logo-titre">
  <title id="logo-titre">Conformly</title>
  <path d="…"/>
</svg>

<!-- Décoratif : -->
<svg aria-hidden="true" focusable="false" viewBox="0 0 24 24"><path d="…"/></svg>

RGAA criterion 1.1 — Images

Chaque image porteuse d’information a-t-elle une alternative textuelle ?

How to check: official tests (in French)

  1. Test 1.1.1

    Chaque image (balise <img> ou balise possédant l’attribut WAI-ARIA role="img") porteuse d’information a-t-elle une alternative textuelle ?

  2. Test 1.1.2

    Chaque zone d’une image réactive (balise <area>) porteuse d’information a-t-elle une alternative textuelle ?

  3. Test 1.1.3

    Chaque bouton de type image (balise <input> avec l’attribut type="image") a-t-il une alternative textuelle ?

  4. Test 1.1.4

    Chaque zone cliquable d’une image réactive côté serveur est-elle doublée d’un mécanisme utilisable quel que soit le dispositif de pointage utilisé et permettant d’accéder à la même destination ?

  5. Test 1.1.5

    Chaque image vectorielle (balise <svg>) porteuse d’information, vérifie-t-elle ces conditions ?

    La balise <svg> possède un attribut WAI-ARIA role="img" ;

    La balise <svg> a une alternative textuelle.

  6. Test 1.1.6

    Chaque image objet (balise <object> avec l’attribut type="image/…") porteuse d’information, vérifie-t-elle une de ces conditions ?

    La balise <object> possède une alternative textuelle et un attribut role="img" ;

    L’élément <object> est immédiatement suivi d’un lien ou bouton adjacent permettant d’accéder à un contenu alternatif ;

    Un mécanisme permet à l’utilisateur de remplacer l’élément <object> par un contenu alternatif.

  7. Test 1.1.7

    Chaque image embarquée (balise <embed> avec l’attribut type="image/…") porteuse d’information, vérifie-t-elle une de ces conditions ?

    La balise <embed> possède une alternative textuelle et un attribut role="img" ;

    L’élément <embed> est immédiatement suivi d’un lien ou bouton adjacent permettant d’accéder à un contenu alternatif ;

    Un mécanisme permet à l’utilisateur de remplacer l’élément <embed> par un contenu alternatif.

  8. Test 1.1.8

    Chaque image bitmap (balise <canvas>) porteuse d’information, vérifie-t-elle une de ces conditions  ?

    La balise <canvas> possède une alternative textuelle et un attribut role="img" ;

    Un contenu alternatif est présent entre les balises <canvas> et </canvas> ;

    L‘élément <canvas> est immédiatement suivi d’un lien ou bouton adjacent permettant d’accéder à un contenu alternatif ;

    Un mécanisme permet à l’utilisateur de remplacer l’élément <canvas> par un contenu alternatif.

Full page for criterion 1.1 · Official text: Référentiel général d'amélioration de l'accessibilité (RGAA) 4.1, DINUM, Licence Ouverte 2.0.

Check your site in 30 seconds

Conformly detects this kind of issue across all your pages, continuously, and alerts you on every regression.

Free scan

Other fixes — Images