CKTIS / JavaScript
Image — vytvorenie obrázkového prvku
Image vytvorí HTMLImageElement mimo stromu dokumentu. Voliteľné argumenty nastavia rozmery, ale nenačítajú obrázok ani nezmenia veľkosť jeho súboru.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
new Image(); new Image(width); new Image(width, height)new Image() vytvorí prvok img typu HTMLImageElement, podobne ako document.createElement("img"). Nevloží ho do dokumentu. Image je HTML API dostupné v prostredí Window, nie je súčasťou ECMAScriptu; prítomnosť Node 24 v repozitári nedokazuje dostupnosť tohto API. Súčasné prehliadačové enginy tento konštruktor podporujú.
Voliteľné argumenty width a height nastavia príslušné atribúty rozmerov. Nemenia obrazové údaje; CSS môže ovplyvniť konečnú zobrazovanú veľkosť. naturalWidth a naturalHeight opisujú prirodzené rozmery korigované podľa hustoty v pixeloch CSS; pred sprístupnením obrázka majú hodnotu 0.
Nastavením src sa spustí asynchrónne spracovanie zdroja, aj mimo stromu dokumentu. Pred zobrazením obrázka spracujte udalosti load a error alebo splnenie či zamietnutie promise decode(). Samotné complete === true nedokazuje úspech: platí aj pri chýbajúcom zdroji alebo chybe. Pri zobrazovaní obrázka nastavte vhodné alt.
Príklady
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);Výsledok
true 32 16 false 0 0
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.