CKTIS / JavaScript
Image — vytvoření obrázkového prvku
Image vytvoří HTMLImageElement mimo strom dokumentu. Volitelné argumenty nastaví rozměry, ale nenačtou obrázek ani nezmění velikost jeho souboru.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
new Image(); new Image(width); new Image(width, height)new Image() vytvoří prvek img typu HTMLImageElement, podobně jako document.createElement("img"). Nevloží ho do dokumentu. Image je HTML API dostupné v prostředí Window, není součástí ECMAScriptu; přítomnost Node 24 v repozitáři nedokládá dostupnost tohoto API. Současné prohlížečové enginy tento konstruktor podporují.
Volitelné argumenty width a height nastaví odpovídající atributy rozměrů. Nemění obrazová data; CSS může ovlivnit konečnou zobrazovanou velikost. naturalWidth a naturalHeight udávají přirozené rozměry korigované podle hustoty v pixelech CSS; před zpřístupněním obrázku mají hodnotu 0.
Nastavením src se spustí asynchronní zpracování prostředku, a to i mimo strom dokumentu. Před zobrazením obrázku zpracujte události load a error nebo splnění či zamítnutí příslibu decode(). Samotné complete === true úspěch nedokazuje: platí také při chybějícím zdroji nebo při chybě. Při zobrazení obrázku nastavte vhodné alt.
Pří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ýsledek
true 32 16 false 0 0
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.