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

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.

Viri