CKTIS / JavaScript
HTMLImageElement.alt — tekst alternatywny obrazu
HTMLImageElement.alt odczytuje i ustawia tekstowy zamiennik obrazu. Właściwość odzwierciedla atrybut alt; pusty tekst i brak atrybutu nie oznaczają tego samego.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
image.alt
image.alt = "Replacement text";HTMLImageElement.alt to zapisywalna właściwość typu DOMString, która odzwierciedla atrybut alt elementu img. Odczyt zwraca jego wartość, a przypisanie aktualizuje atrybut. Gdy atrybut nie istnieje, odczyt zwraca "".
Tekst powinien zastępować znaczenie obrazu w danym kontekście, a nie tylko opisywać jego wygląd. Dla obrazu dekoracyjnego lub powielającego sąsiednią informację użyj image.alt = "". Brak atrybutu nie jest równoważny pustej wartości. alt nie jest podpowiedzią typu title.
Przykład rozróżnia brak atrybutu od pustej wartości za pomocą hasAttribute("alt") i pokazuje zmianę widoczną przez getAttribute("alt"). Uruchom go w przeglądarce: to interfejs HTML DOM, nie funkcja języka ECMAScript. Obecność Node 24 w repozytorium nie potwierdza dostępności tego interfejsu.
Przykłady
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")]));Wynik
["",false] Orange cat sleeping ["",true]
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.