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

CKTIS / JavaScript

HTMLImageElement: nalaganje slik, dimenzije in stanje complete

HTMLImageElement omogoča nastavitev vira slike in nadomestnega besedila, obravnavo dogodkov load in error ter branje naravnih dimenzij. Lastnost complete ne dokazuje uspeha: vrednost true ima tudi pri poškodovani sliki ali elementu brez vira.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

const image = new Image();
image.alt = description;
image.addEventListener("load", onLoad, { once: true });
image.addEventListener("error", onError, { once: true });
image.src = url;
// Read: image.naturalWidth, image.naturalHeight, image.complete

HTMLImageElement predstavlja slikovni element; new Image() ga ustvari, ne da bi ga dodal v dokument. HTMLImageElement.src nastavi URL vira, HTMLImageElement.alt pa nadomestno besedilo. Za informativno sliko podaj smiseln opis; za okrasno uporabi prazen alt.

HTMLImageElement.load in HTMLImageElement.error tukaj označujeta dogodka load in error, ne metod, ki bi ju klicali. Prvi sporoča uspešno nalaganje, drugi napako pri nalaganju ali izrisu. Oba poslušalnika registriraj z addEventListener pred nastavitvijo src, da se hitro nalaganje ne konča, še preden sta registrirana.

Lastnosti samo za branje HTMLImageElement.naturalWidth in HTMLImageElement.naturalHeight podajata za gostoto popravljeni naravni dimenziji v slikovnih pikah CSS, ne velikosti, določene s slogi. Nedosegljiva dimenzija ima vrednost 0. HTMLImageElement.complete je samo za branje: vrednost true ima lahko po uspehu, po napaki, brez vira ali s praznim src. Sam complete torej ne dokazuje uspeha.

Pri obstoječem elementu najprej registriraj oba poslušalnika in nato preveri trenutno stanje. Če element nima vira, ta primer obravnavaj ločeno, vendar upoštevaj, da vir lahko zagotovi nadrejeni element picture. Če ima element vir in je complete enak false, počakaj na load ali error. Pogoj complete && naturalWidth > 0 ne dokazuje, da se je slika uspešno naložila. Pri elementu img brez lastnih atributov src in srcset je lahko complete enak true, medtem ko se slika, ki jo določa nadrejeni picture, še nalaga. naturalWidth lahko dobi pozitivno vrednost, takoj ko so dimenzije na voljo, še preden se nalaganje konča. Če velja complete && naturalWidth === 0, iz teh lastnosti prav tako ne moreš razbrati izida: tudi slika brez lastne širine se lahko uspešno naloži. Na tej podlagi je ne obravnavaj kot nedosegljive. Če imaš za trenutno zahtevo za sliko zabeležen dogodek load ali error, uporabi ta izid. Na novo registriran poslušalnik ne bo prejel dogodka, ki se je že sprožil. Poskrbi, da se pri preverjanju stanja in obravnavi dogodkov isti rezultat ne obravnava dvakrat.

To je brskalniški API, določen s HTML, in ne funkcija določene izdaje ECMAScript. Opisani osnovni mehanizmi so široko podprti; prisotnost Node 24 v repozitoriju ne dokazuje, da je brskalniški API na voljo. Primer ustvari okrasno sliko SVG v pomnilniku, ne da bi jo dodal v dokument. SVG ima izrecno določeni pozitivni širino in višino, zato primer ne prikazuje uspešnega nalaganja slike brez lastne širine.

Primeri

(() => {
  const image = new Image();
  image.alt = "";

  image.addEventListener("load", () => {
    console.log(`load: ${image.naturalWidth}x${image.naturalHeight}; complete=${image.complete}`);
  }, { once: true });

  image.addEventListener("error", () => {
    console.log("error: image unavailable");
  }, { once: true });

  const svg = '<svg xmlns="http://www.w3.org/2000/svg" width="2" height="3"><rect width="2" height="3" fill="blue"/></svg>';
  image.src = `data:image/svg+xml,${encodeURIComponent(svg)}`;
})();

Rezultat

load: 2x3; complete=true

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri