Free scan

Fix "role=img element without alternative" in HTML

Why it's a problem

role="img" declares an element to be an image: the screen reader announces it as such and ignores its content. Without an accessible name it only says “image”, nothing about what it shows — typical of icon fonts and CSS background images.

How to fix it — HTML

Name it with aria-label (or aria-labelledby pointing to visible text). If the image is decorative, drop role="img" and hide it with aria-hidden="true". For a real content image, a plain <img alt="…"> is simpler.

Avoid
<span class="icon icon-alerte" role="img"></span>
Correct
<!-- Image porteuse d'information : un nom -->
<span class="icon icon-alerte" role="img" aria-label="Alerte : régression détectée"></span>

<!-- Icône décorative à côté d'un texte : masquée -->
<span class="icon icon-alerte" aria-hidden="true"></span> Régression détectée

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