Votre site web est-il accessible ?Vérifier gratuitement
WCAG 1.1.1Niveau APerceptible

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.

Exemple
<!-- 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="">
À faire

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.

À éviter

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.

    • 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 alternatif
    • Lien 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’erreur
    • Bouton 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’erreur
    • Images 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

    Confiez l’accessibilité de votre site web à l’IA

    Conçu en Europe. Installation en 2 minutes, sans développeur. Mettez l’accessibilité de votre site web en pilote automatique grâce aux corrections par IA et à la surveillance automatisée.

    1. 1Choisir votre offre
    2. 2Installation en 2 min
    3. 3L’IA corrige votre site
    4. Terminé