CKTIS / JavaScript
Slike v JavaScriptu: `src`, `alt`, `load` in `error`
Nastavi naslov in nadomestno besedilo slike ter se z dogodkoma na slikovnem elementu odzovi na uspešno ali neuspešno nalaganje.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
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() ustvari element img tipa HTMLImageElement, ki sprva ni v drevesu dokumenta. To je API spletne platforme in ne del ECMAScripta 2024. Izvajalno okolje ga mora zagotavljati.
img.src je lastnost z vrednostjo niza, ki odraža atribut src. Nastavitev sproži asinhrono obdelavo vira slike, tudi če element ni vstavljen v dokument. Pri branju img.src se veljavni relativni URL razreši glede na osnovni URL dokumenta; img.getAttribute("src") vrne shranjeno vrednost atributa. Pri odzivnih slikah img.currentSrc pove, kateri URL je izbral brskalnik.
img.alt odraža atribut alt. Napiši besedilo, ki osebi, ki slike ne vidi, v danem kontekstu sporoči njen pomen ali namen. Za povsem okrasne slike nastavi alt = "", namesto da atribut izpustiš. alt ni URL nadomestne slike.
load pomeni, da se je slika uspešno naložila; error pomeni, da izbranega vira ni bilo mogoče naložiti ali uporabiti. To sta dogodka elementa, ne metodi ali izjemi, ki bi ju prestregel try...catch okoli prireditve v src. Oba poslušalca dogodkov registriraj pred nastavitvijo src. Lahko pa prirediš obdelovalni funkciji lastnostma onload in onerror; nova prireditev zamenja funkcijo v tisti lastnosti.
Primeri
<!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>Rezultat
load: Blue dot error: Blue dot
Shrani primer kot datoteko HTML, odpri jo v brskalniku in preveri izpis v razvijalski konzoli. Brez omrežnih zahtev najprej preizkusi veljaven SVG, nato neveljavne slikovne podatke. Obe vrstici izpišeta dogodek in nespremenjeno vrednost `alt`; ne prikazujeta, kako brskalnik prikaže nadomestno besedilo. Če varnostni pravilnik za vsebino (CSP) blokira slike `data:`, se lahko `error` sproži že pri prvem preizkusu.
Povezane lekcije
- JavaScript · Lekcija 30 · Srednja · Različica: 3