База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

HTMLImageElement.alt — алтернативен текст на изображението

HTMLImageElement.alt прочита и задава текстовия заместител на изображение. Свойството отразява атрибута alt; празният низ и липсващият атрибут не означават едно и също.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

image.alt
image.alt = "Replacement text";

HTMLImageElement.alt е свойство от тип DOMString, което може да се записва и отразява атрибута alt на елемент img. При прочитане връща стойността му, а задаването на стойност актуализира атрибута. Ако атрибутът липсва, прочитането връща "".

Текстът трябва да замества значението на изображението в контекста, а не просто да описва външния му вид. За декоративно изображение или изображение, което повтаря съседна информация, използвайте image.alt = "". Липсващият атрибут не е равнозначен на празна стойност. alt не е подсказка като title.

Примерът различава липсващ атрибут от празна стойност чрез hasAttribute("alt") и показва промяната, видима чрез getAttribute("alt"). Изпълнете го в браузър: това е интерфейс на HTML DOM, а не функция на езика ECMAScript. Наличието на Node 24 в хранилището не доказва, че този интерфейс е достъпен.

Примери

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")]));

Резултат

["",false]
Orange cat sleeping
["",true]

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници