CKTIS / JavaScript
HTMLImageElement.alt — texte de remplacement de l’image
HTMLImageElement.alt lit et définit le texte de remplacement d’une image. La propriété reflète l’attribut alt ; une chaîne vide et un attribut absent ne signifient pas la même chose.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
image.alt
image.alt = "Replacement text";HTMLImageElement.alt est une propriété DOMString modifiable qui reflète l’attribut alt d’un élément img. La lecture renvoie sa valeur, et une affectation met à jour l’attribut. Si l’attribut est absent, la lecture renvoie "".
Le texte doit remplacer le sens de l’image dans son contexte, et non simplement décrire son apparence. Pour une image décorative ou qui répète une information voisine, utilisez image.alt = "". Un attribut absent n’équivaut pas à une valeur vide. alt n’est pas une infobulle comme title.
L’exemple distingue l’absence de l’attribut d’une valeur vide avec hasAttribute("alt") et montre la modification visible via getAttribute("alt"). Exécutez-le dans un navigateur : il s’agit d’une interface du DOM HTML, et non d’une fonctionnalité du langage ECMAScript. La présence de Node 24 dans le dépôt ne garantit pas la disponibilité de cette interface.
Exemples
const image = document.createElement("img");
console.log(JSON.stringify([image.alt, image.hasAttribute("alt")]));
image.alt = "Orange cat sleeping";
console.log(image.getAttribute("alt"));
image.alt = "";
console.log(JSON.stringify([image.alt, image.hasAttribute("alt")]));Résultat
["",false] Orange cat sleeping ["",true]
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.