CKTIS / JavaScript
Afbeeldingen in JavaScript: `src`, `alt`, `load` en `error`
Stel de URL en alternatieve tekst van een afbeelding in en reageer met gebeurtenissen op het element op geslaagd of mislukt laden.
Versie: 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() maakt een img-element van het type HTMLImageElement dat aanvankelijk buiten de documentboom staat. Dit is een API van het webplatform, geen onderdeel van ECMAScript 2024. De uitvoeringsomgeving moet de API aanbieden.
img.src is een tekenreekseigenschap die het attribuut src weerspiegelt. Instellen start de asynchrone verwerking van de afbeeldingsbron, ook als het element niet in het document is opgenomen. Bij het uitlezen van img.src wordt een geldige relatieve URL opgelost ten opzichte van de basis-URL van het document; img.getAttribute("src") geeft de opgeslagen attribuutwaarde terug. Bij responsieve afbeeldingen geeft img.currentSrc aan welke URL de browser heeft gekozen.
img.alt weerspiegelt het attribuut alt. Schrijf tekst die de betekenis of functie van de afbeelding in haar context overbrengt aan iemand die haar niet kan zien. Gebruik alt = "" voor een puur decoratieve afbeelding in plaats van het attribuut weg te laten. alt is geen URL van een vervangende afbeelding.
load geeft aan dat de afbeelding is geladen; error geeft aan dat de gekozen bron niet kon worden geladen of gebruikt. Het zijn gebeurtenissen op het element, geen methoden of uitzonderingen die je met try...catch rond de toewijzing aan src opvangt. Registreer beide listeners voordat je src instelt. Je kunt ook handlers toewijzen aan onload en onerror; een nieuwe toewijzing vervangt de handler van die eigenschap.
Voorbeelden
<!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>Resultaat
load: Blue dot error: Blue dot
Sla het voorbeeld op als HTML-bestand, open het in een browser en bekijk de uitvoer in de ontwikkelaarsconsole. De code test eerst een geldige SVG en daarna ongeldige afbeeldingsgegevens, zonder netwerkverzoeken. Beide regels tonen de gebeurtenis en de ongewijzigde `alt`-waarde, niet hoe de browser de alternatieve tekst weergeeft. Een Content Security Policy die `data:`-afbeeldingen blokkeert, kan ook bij de eerste test `error` veroorzaken.
Gerelateerde lessen
- JavaScript · Les 30 · Gemiddeld · Versie: 3