Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

HTMLImageElement.alt — alternativní text obrázku

HTMLImageElement.alt čte textovou náhradu obrázku a nastavuje ji. Vlastnost odráží atribut alt; prázdný řetězec a chybějící atribut neznamenají totéž.

Verze: 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 je zapisovatelná vlastnost typu DOMString, která odráží atribut alt prvku img. Při čtení vrací jeho hodnotu a při přiřazení se atribut aktualizuje. Pokud atribut chybí, čtení vrátí "".

Text by měl v daném kontextu nahrazovat význam obrázku, nikoli pouze popisovat jeho vzhled. U dekorativního obrázku nebo obrázku, který opakuje okolní informace, použijte image.alt = "". Chybějící atribut není totéž co prázdná hodnota. alt není nápověda jako title.

Příklad pomocí hasAttribute("alt") rozlišuje chybějící atribut od prázdné hodnoty a ukazuje změnu viditelnou přes getAttribute("alt"). Spusťte jej v prohlížeči: jde o rozhraní HTML DOM, nikoli o vlastnost jazyka ECMAScript. Přítomnost Node 24 v repozitáři nedokládá dostupnost tohoto rozhraní.

Příklady

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

Výsledek

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

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje