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