Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

HTMLImageElement : propriété alt

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.

La propriété alt de l'interface HTMLImageElement fournit un texte de remplacement (alternatif) à afficher lorsque l'image définie par l'élément HTML <img> n'est pas affichée, que ce soit à cause d'une erreur, parce que l'utilisateur·ice a désactivé le chargement des images, ou parce que l'image n'a pas encore fini de se charger. Elle reflète l'attribut de contenu alt de l'élément <img>.

Il existe des implications importantes en matière d'accessibilité lors de la fourniture d'un texte alternatif approprié, et les exigences peuvent différer selon l'objectif de l'image. Voir la référence HTML <img> pour plus d'informations.

Valeur

Une chaîne de caractères.

Exemples

Définir l'attribut alt

js
const img = new Image();
img.src = "example.png";
img.alt = "Une image d'exemple";

Spécifications

Specification
HTML
# dom-img-alt

Compatibilité des navigateurs