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.
<span class="icon icon-alerte" role="img"></span><!-- 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éeRGAA criterion 1.1 — Images
Chaque image porteuse d’information a-t-elle une alternative textuelle ?
How to check: official tests (in French)
Test 1.1.1
Chaque image (balise
<img>ou balise possédant l’attribut WAI-ARIArole="img") porteuse d’information a-t-elle une alternative textuelle ?Test 1.1.2
Chaque zone d’une image réactive (balise
<area>) porteuse d’information a-t-elle une alternative textuelle ?Test 1.1.3
Chaque bouton de type
image(balise<input>avec l’attributtype="image") a-t-il une alternative textuelle ?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 ?
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-ARIArole="img";La balise
<svg>a une alternative textuelle.Test 1.1.6
Chaque image objet (balise
<object>avec l’attributtype="image/…") porteuse d’information, vérifie-t-elle une de ces conditions ?La balise
<object>possède une alternative textuelle et un attributrole="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.Test 1.1.7
Chaque image embarquée (balise
<embed>avec l’attributtype="image/…") porteuse d’information, vérifie-t-elle une de ces conditions ?La balise
<embed>possède une alternative textuelle et un attributrole="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.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 attributrole="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