Attribut alt manquant : l’erreur expliquée et corrigée
Autres noms: Image sans attribut alt, Les images doivent avoir un texte alternatif, Pas d’attribut alt
Définition
Un attribut alt manquant signifie qu’un élément img (ou un bouton image, ou une zone de carte image) n’a aucun attribut alt. Les technologies d’assistance ne peuvent pas savoir si l’image est informative ou décorative et risquent de lire le nom du fichier à la place.
Un attribut alt manquant est l’erreur signalée par les outils d’analyse quand une balise image n’a aucun attribut alt. Elle apparaît sous les intitulés « Image missing alt attribute » ou « Images must have alternate text » (image sans attribut alt, les images doivent avoir un texte alternatif). Cette page traite de l’erreur elle-même : pour rédiger de bonnes descriptions, consultez le guide du texte alternatif.
Ce que cela signifie
L’attribut alt est le moyen par lequel une image indique aux lecteurs d’écran ce qu’elle montre. Quand l’attribut est totalement absent, les technologies d’assistance n’ont aucune information : elles ne peuvent pas savoir si l’image compte ou si elle est purement décorative. Les lecteurs d’écran se rabattent alors parfois sur le nom du fichier, et c’est « IMG_4711.jpg » ou « hero-banner-final-2.webp » qui est lu à voix haute au lieu d’un vrai contenu.
Le critère WCAG 1.1.1 Contenu non textuel est un critère de niveau A des WCAG 2.2 : tout contenu non textuel a besoin d’un équivalent textuel qui remplit une fonction équivalente, et les images purement décoratives doivent être masquées aux technologies d’assistance. Le W3C classe comme cas d’échec F65 l’omission de l’attribut alt ou de l’équivalent textuel sur les éléments img, les éléments area et les éléments input de type image. Les noms de fichier ou les textes de substitution utilisés comme texte alternatif constituent aussi un cas d’échec (F30).
| Balisage | Ce que dit l’outil d’analyse | Ce que cela signifie |
|---|---|---|
<img src="team.jpg"> |
Attribut alt manquant | Aucune information : à corriger |
<img src="line.svg" alt=""> |
Pas d’erreur | Image décorative, ignorée à juste titre |
<img src="team.jpg" alt="Our team of five at the office"> |
Pas d’erreur | Image informative, décrite |
<img src="team.jpg" alt="IMG_4711.jpg"> |
Souvent pas d’erreur | Enfreint quand même le critère 1.1.1 (F30) |
Exemples
L’erreur se cache souvent dans les images de produits, les logos et les images placées dans des liens. Quand l’image est le seul contenu d’un lien ou d’un bouton, l’alt manquant crée aussi un lien vide ou un bouton vide.
<!-- Error: no alt attribute -->
<img src="/images/sneaker-red.jpg">
<!-- Fixed: informative image -->
<img src="/images/sneaker-red.jpg" alt="Red running sneaker, side view">
<!-- Fixed: decorative image -->
<img src="/images/divider.svg" alt="">Décidez pour chaque image : informative → décrivez son contenu ou sa fonction ; décorative → alt="". Définissez le texte alternatif dans la médiathèque de votre CMS, pour qu’il soit repris partout où l’image apparaît.
Omettre l’attribut, le remplir avec le nom du fichier, ou écrire « image » ou « spacer » pour les images décoratives : le W3C classe cela comme cas d’échec (F39).
Comment corriger un attribut alt manquant
Les boutiques en ligne sont les plus touchées, car chaque photo de produit compte. Dans Shopify et WooCommerce sur WordPress, le texte alternatif se définit image par image dans les réglages des médias ou des produits.
Questions fréquentes
Que signifie l’erreur « image missing alt attribute » ?
La balise <img> n’a aucun attribut alt. Les lecteurs d’écran n’ont pas d’équivalent textuel et risquent de lire le nom du fichier à la place.
Un alt="" équivaut-il à un attribut alt manquant ?
Non. alt="" marque une image comme décorative pour que les lecteurs d’écran l’ignorent : c’est correct pour une décoration. Un attribut absent est une erreur, car personne n’a décidé si l’image compte.
Les images décoratives ont-elles besoin d’un attribut alt ?
Oui, d’un attribut vide : alt="". L’omettre enfreint le critère WCAG 1.1.1 ; le W3C le classe comme cas d’échec F65.
Comment trouver les images sans attribut alt ?
Lancez le vérificateur WCAG gratuit sur votre page d’accueil. Pour une seule image, faites un clic droit dessus et choisissez Inspecter pour voir si l’attribut existe.
allyWay peut-il corriger automatiquement les attributs alt manquants ?
Oui. L’IA d’allyWay examine vos images et rédige des textes alternatifs qui décrivent ce qu’elles montrent réellement, puis les applique sur chaque page. Les corrections automatiques passent par le script allyWay : votre CMS, votre thème et vos fichiers restent tels quels, et chaque correction est consignée. Commencez gratuitement et donnez des équivalents textuels à vos images sans les modifier une par une.
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 alternatifLien vide : comprendre et corriger l’erreur
Un lien vide est un élément de lien sans nom accessible : pas de texte, pas de texte alternatif sur une image qu’il contient et pas d’aria-label. Les lecteurs d’écran ne peuvent l’annoncer que comme un simple lien, et l’utilisateur ne sait pas où il mène.
Lire la définition: Lien vide : comprendre et corriger l’erreurBouton vide : comprendre et corriger l’erreur
Un bouton vide est un élément bouton sans nom accessible : ni texte, ni aria-label, ni texte alternatif sur une image qu’il contient. Les lecteurs d’écran annoncent seulement qu’il s’agit d’un bouton, pas ce qu’il fait.
Lire la définition: Bouton vide : comprendre et corriger l’erreurImages 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 choix