CKTIS / JavaScript
Image — stvaranje slikovnog elementa
Image stvara HTMLImageElement izvan stabla dokumenta. Neobavezni argumenti postavljaju dimenzije, ali ne učitavaju sliku niti mijenjaju veličinu njezine datoteke.
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
new Image(); new Image(width); new Image(width, height)new Image() stvara element img vrste HTMLImageElement, kao i document.createElement("img"). Ne umeće ga u dokument. Image je HTML API dostupan u okruženju Window i nije dio ECMAScripta; prisutnost Nodea 24 u repozitoriju ne dokazuje dostupnost ovog API-ja. Suvremeni preglednički pogoni podržavaju ovaj konstruktor.
Neobavezni argumenti width i height postavljaju odgovarajuće atribute dimenzija. Ne mijenjaju podatke slike; CSS može utjecati na konačnu prikazanu veličinu. naturalWidth i naturalHeight opisuju prirodne dimenzije korigirane prema gustoći, u CSS pikselima; prije nego što je slika dostupna, imaju vrijednost 0.
Postavljanje src pokreće asinkronu obradu resursa, čak i izvan stabla dokumenta. Prije prikazivanja slike obradi događaje load i error ili ispunjenje odnosno odbijanje obećanja decode(). Sam complete === true ne dokazuje uspjeh: vrijedi i kad izvor nedostaje ili je došlo do pogreške. Pri prikazivanju slike postavi odgovarajući alt.
Primjeri
const image = new Image(32, 16);
console.log(image instanceof HTMLImageElement);
console.log(image.width, image.height);
console.log(image.isConnected);
console.log(image.naturalWidth, image.naturalHeight);Rezultat
true 32 16 false 0 0
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.