CKTIS / JavaScript
Bilder in JavaScript: `src`, `alt`, `load` und `error`
Lege die Bild-URL und den Alternativtext fest und reagiere mit Ereignissen am Bildelement auf erfolgreiches oder fehlgeschlagenes Laden.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
const img = new Image();
img.alt = text;
img.addEventListener("load", onLoad);
img.addEventListener("error", onError);
// To use handler properties, replace the two listener registrations above with:
// img.onload = onLoad;
// img.onerror = onError;
img.src = url;new Image() erzeugt ein img-Element vom Typ HTMLImageElement, das zunächst nicht im Dokumentbaum steht. Die API gehört zur Webplattform, nicht zu ECMAScript 2024. Die Laufzeitumgebung muss sie bereitstellen.
img.src ist eine Zeichenketteneigenschaft, die das Attribut src widerspiegelt. Das Setzen startet die asynchrone Verarbeitung der Bildquelle auch ohne Einfügen des Elements in das Dokument. Beim Lesen von img.src wird eine gültige relative URL gegen die Basis-URL des Dokuments aufgelöst; img.getAttribute("src") liefert den gespeicherten Attributwert. Bei responsiver Bildauswahl zeigt img.currentSrc, welche URL der Browser ausgewählt hat.
img.alt spiegelt das Attribut alt wider. Der Text soll Menschen, die das Bild nicht sehen können, seine Bedeutung oder Funktion im jeweiligen Kontext vermitteln. Setze bei rein dekorativen Bildern alt = "", statt das Attribut wegzulassen. alt ist keine URL für ein Ersatzbild.
load meldet erfolgreiches Laden; error meldet, dass die gewählte Ressource nicht geladen oder verwendet werden konnte. Das sind Ereignisse des Elements, keine Methoden oder Ausnahmen, die ein try...catch um die Zuweisung an src abfängt. Registriere beide Listener vor dem Setzen von src. Alternativ kannst du onload und onerror setzen; eine erneute Zuweisung ersetzt den Handler der jeweiligen Eigenschaft.
Beispiele
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Image load and error events</title>
</head>
<body>
<script>
(async () => {
const svg = '<svg xmlns="http://www.w3.org/2000/svg" width="10" height="10"><circle cx="5" cy="5" r="5" fill="blue"/></svg>';
const valid = 'data:image/svg+xml,' + encodeURIComponent(svg);
const invalid = 'data:image/svg+xml,not-an-svg';
function reportImage(url) {
return new Promise((resolve) => {
const img = new Image();
img.alt = 'Blue dot';
const report = (event) => {
console.log(`${event.type}: ${img.alt}`);
resolve();
};
img.addEventListener('load', report, { once: true });
img.addEventListener('error', report, { once: true });
img.src = url;
});
}
await reportImage(valid);
await reportImage(invalid);
})();
</script>
</body>
</html>Ergebnis
load: Blue dot error: Blue dot
Speichere das Beispiel als HTML-Datei, öffne sie im Browser und prüfe die Ausgabe in der Entwicklerkonsole. Es testet ohne Netzwerkanfragen zuerst ein gültiges SVG und dann ungültige Bilddaten. Beide Zeilen melden das Ereignis und den unveränderten Wert von `alt`; sie zeigen nicht, wie der Browser Alternativtext darstellt. Blockiert die Content Security Policy `data:`-Bilder, kann schon der erste Test `error` auslösen.
Zugehörige Lektionen
- JavaScript · Lektion 30 · Mittlere Stufe · Version: 3