Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

HTMLImageElement: učitavanje slika, dimenzije i stanje complete

HTMLImageElement omogućuje postavljanje izvora i zamjenskog teksta slike, obradu događaja load i error te čitanje prirodnih dimenzija. Svojstvo complete ne dokazuje uspjeh: vrijednost true ima i za oštećenu sliku ili element bez izvora.

Verzija: 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() stvara ga bez dodavanja u dokument. HTMLImageElement.src postavlja URL resursa, a HTMLImageElement.alt zamjenski tekst. Za informativnu sliku navedi smislen opis; za ukrasnu upotrijebi prazan alt.

HTMLImageElement.load i HTMLImageElement.error ovdje označavaju događaje load i error, a ne metode koje se pozivaju. Prvi signalizira uspješno učitavanje, a drugi pogrešku pri učitavanju ili prikazu. Registriraj oba osluškivača pomoću addEventListener prije postavljanja src kako se brzo učitavanje ne bi završilo prije registracije.

Svojstva samo za čitanje HTMLImageElement.naturalWidth i HTMLImageElement.naturalHeight daju gustoćom korigirane prirodne dimenzije u CSS pikselima, a ne veličinu određenu stilovima. Nedostupna dimenzija ima vrijednost 0. HTMLImageElement.complete samo je za čitanje: može biti true nakon uspjeha, nakon pogreške, bez izvora ili s praznim src. Sam complete stoga ne dokazuje uspjeh.

Za postojeći element najprije registriraj oba osluškivača, a zatim provjeri trenutačno stanje. Ako element nema izvor, obradi taj slučaj zasebno, ali imaj na umu da izvor može zadati nadređeni element picture. Ako element ima izvor i complete ima vrijednost false, pričekaj load ili error. Uvjet complete && naturalWidth > 0 ne dokazuje da je slika uspješno učitana. Za img bez vlastitih atributa src i srcset, complete može imati vrijednost true dok se slika koju određuje nadređeni picture još učitava. naturalWidth može poprimiti pozitivnu vrijednost čim dimenzije postanu dostupne, prije završetka učitavanja. Ako vrijedi complete && naturalWidth === 0, iz tih svojstava također ne možeš utvrditi ishod: i slika bez vlastite širine može se uspješno učitati. Nemoj je na temelju toga smatrati nedostupnom. Ako je za trenutačni zahtjev za sliku zabilježen događaj load ili error, upotrijebi taj ishod. Novoregistrirani osluškivač neće primiti događaj koji se već dogodio. Spriječi da provjera stanja i osluškivači dvaput obrade isti rezultat.

Ovo je API preglednika definiran standardom HTML, a ne značajka određenog izdanja ECMAScripta. Opisani osnovni mehanizmi široko su podržani; prisutnost Node 24 u repozitoriju ne dokazuje dostupnost API-ja preglednika. Primjer stvara ukrasnu SVG sliku u memoriji, bez dodavanja u dokument. SVG ima izričito zadanu pozitivnu širinu i visinu pa primjer ne prikazuje uspješno učitavanje slike bez vlastite širine.

Primjeri

(() => {
  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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori