CKTIS / JavaScript
HTMLImageElement.alt — testo alternativo dell’immagine
HTMLImageElement.alt legge e imposta il testo sostitutivo di un’immagine. La proprietà riflette l’attributo alt; una stringa vuota e un attributo assente non significano la stessa cosa.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
image.alt
image.alt = "Replacement text";HTMLImageElement.alt è una proprietà DOMString scrivibile che riflette l’attributo alt di un elemento img. La lettura restituisce il suo valore e l’assegnazione aggiorna l’attributo. Se l’attributo è assente, la lettura restituisce "".
Il testo dovrebbe sostituire il significato dell’immagine nel contesto, non limitarsi a descriverne l’aspetto. Per un’immagine decorativa o che ripete informazioni adiacenti, usa image.alt = "". L’assenza dell’attributo non equivale a un valore vuoto. alt non è un suggerimento a comparsa come title.
L’esempio distingue l’assenza dell’attributo da un valore vuoto usando hasAttribute("alt") e mostra la modifica visibile tramite getAttribute("alt"). Eseguilo in un browser: è un’interfaccia del DOM HTML, non una funzionalità del linguaggio ECMAScript. La presenza di Node 24 nel repository non dimostra che questa interfaccia sia disponibile.
Esempi
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")]));Risultato
["",false] Orange cat sleeping ["",true]
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.