Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Slike u JavaScriptu: `src`, `alt`, `load` i `error`

Postavi adresu i alternativni tekst slike te se pomoću događaja na slikovnom elementu odazovi na uspješno ili neuspješno učitavanje.

Verzija: 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() stvara element img tipa HTMLImageElement koji je u početku izvan stabla dokumenta. Taj API pripada web-platformi, a ne standardu ECMAScript 2024. Izvršno okruženje mora ga pružati.

img.src je svojstvo znakovnog niza koje odražava atribut src. Dodjela vrijednosti pokreće asinkronu obradu izvora slike, čak i ako element nije umetnut u dokument. Pri čitanju img.src valjani relativni URL razrješava se u odnosu na osnovni URL dokumenta; img.getAttribute("src") vraća pohranjenu vrijednost atributa. Za responzivne slike img.currentSrc pokazuje koji je URL preglednik odabrao.

img.alt odražava atribut alt. Napiši tekst koji osobi koja ne može vidjeti sliku prenosi njezino značenje ili svrhu u danom kontekstu. Za čisto ukrasnu sliku postavi alt = "" umjesto da izostaviš atribut. alt nije URL zamjenske slike.

load označava uspješno učitavanje slike; error znači da se odabrani resurs nije mogao učitati ili upotrijebiti. To su događaji elementa, a ne metode ili iznimke koje bi try...catch oko dodjele svojstvu src uhvatio. Registriraj oba slušatelja prije postavljanja src. Možeš i dodijeliti funkcije za obradu događaja svojstvima onload i onerror; nova dodjela zamjenjuje funkciju u tom svojstvu.

Primjeri

<!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

Spremi primjer kao HTML datoteku, otvori je u pregledniku i provjeri ispis u razvojnoj konzoli. Bez mrežnih zahtjeva prvo ispituje valjani SVG, a zatim nevaljane slikovne podatke. Oba retka ispisuju događaj i nepromijenjeni `alt`; ne pokazuju kako preglednik prikazuje alternativni tekst. Pravila sigurnosti sadržaja (CSP) koja blokiraju slike `data:` mogu uzrokovati `error` i u prvom pokušaju.

Povezane lekcije

  • JavaScript · Lekcija 30 · Srednje · Verzija: 3

Izvori