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.