Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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

Viri