Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła