WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

HTMLImageElement.alt — alternativer Bildtext

HTMLImageElement.alt liest den Textersatz eines Bildes aus und legt ihn fest. Die Eigenschaft spiegelt das alt-Attribut wider; eine leere Zeichenfolge und ein fehlendes Attribut bedeuten nicht dasselbe.

Version: 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 ist eine beschreibbare DOMString-Eigenschaft, die das alt-Attribut eines img-Elements widerspiegelt. Beim Lesen wird dessen Wert zurückgegeben, und eine Zuweisung aktualisiert das Attribut. Fehlt das Attribut, wird beim Lesen "" zurückgegeben.

Der Text sollte die Bedeutung des Bildes im jeweiligen Kontext ersetzen und nicht nur sein Aussehen beschreiben. Verwende für ein dekoratives Bild oder eines, das benachbarte Informationen wiederholt, image.alt = "". Ein fehlendes Attribut ist nicht gleichbedeutend mit einem leeren Wert. alt ist kein Tooltip wie title.

Das Beispiel unterscheidet mithilfe von hasAttribute("alt") zwischen einem fehlenden Attribut und einem leeren Wert und zeigt die über getAttribute("alt") sichtbare Änderung. Führe es in einem Browser aus: Dies ist eine HTML-DOM-Schnittstelle und kein Merkmal der ECMAScript-Sprache. Dass Node 24 im Repository vorhanden ist, belegt nicht, dass diese Schnittstelle verfügbar ist.

Beispiele

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

Ergebnis

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

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen