CKTIS / JavaScript
Image — ustvarjanje slikovnega elementa
Image ustvari HTMLImageElement zunaj drevesa dokumenta. Izbirna argumenta določita mere, vendar ne naložita slike ali spremenita velikosti njene datoteke.
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
new Image(); new Image(width); new Image(width, height)new Image() ustvari element img vrste HTMLImageElement, podobno kot document.createElement("img"). Ne vstavi ga v dokument. Image je API HTML, ki je na voljo v okolju Window, in ni del ECMAScript; prisotnost Node 24 v repozitoriju ne dokazuje, da je ta API na voljo. Sodobni brskalniški pogoni podpirajo ta konstruktor.
Izbirna argumenta width in height nastavita ustrezna atributa mer. Podatkov slike ne spremenita; CSS lahko vpliva na končno prikazano velikost. naturalWidth in naturalHeight opisujeta naravne mere, popravljene glede na gostoto, v slikovnih pikah CSS; preden je slika na voljo, sta 0.
Nastavitev src začne asinhrono obdelavo vira, tudi zunaj drevesa dokumenta. Pred prikazom slike obravnavaj dogodka load in error ali izpolnitev oziroma zavrnitev obljube decode(). Sam complete === true ne dokazuje uspeha: velja tudi, če vir manjka ali je prišlo do napake. Pri prikazu slike nastavi ustrezen alt.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.