CKTIS / JavaScript
HTMLImageElement.alt — alternatívny text obrázka
HTMLImageElement.alt číta textovú náhradu obrázka a nastavuje ju. Vlastnosť odráža atribút alt; prázdny reťazec a chýbajúci atribút neznamenajú to isté.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
image.alt
image.alt = "Replacement text";HTMLImageElement.alt je zapisovateľná vlastnosť typu DOMString, ktorá odráža atribút alt prvku img. Pri čítaní vráti jeho hodnotu a pri priradení sa atribút aktualizuje. Ak atribút chýba, čítanie vráti "".
Text by mal v danom kontexte nahrádzať význam obrázka, nielen opisovať jeho vzhľad. Pri dekoratívnom obrázku alebo obrázku, ktorý opakuje susedné informácie, použite image.alt = "". Chýbajúci atribút nie je to isté ako prázdna hodnota. alt nie je bublinová pomôcka ako title.
Príklad pomocou hasAttribute("alt") rozlišuje chýbajúci atribút od prázdnej hodnoty a ukazuje zmenu viditeľnú cez getAttribute("alt"). Spustite ho v prehliadači: ide o rozhranie HTML DOM, nie o vlastnosť jazyka ECMAScript. Prítomnosť Node 24 v repozitári nedokazuje dostupnosť tohto rozhrania.
Prí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ýsledok
["",false] Orange cat sleeping ["",true]
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.