HTMLImageElement: Image() Konstruktor

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Der Image() Konstruktor erstellt eine neue Instanz von HTMLImageElement. Er ist funktional äquivalent zu document.createElement('img').

Hinweis: Diese Funktion sollte nicht mit der CSS-Funktion image() verwechselt werden.

Syntax

new Image()
new Image(width)
new Image(width, height)

Parameter

width Optional: Die Breite des Bildes (d.h. der Wert für das width Attribut).
height Optional: Die Höhe des Bildes (d.h. der Wert für das height Attribut).

Das gesamte Bitmap wird geladen, unabhängig von den im Konstruktor angegebenen Größen. Die im Konstruktor angegebene Größe spiegelt sich in den Eigenschaften HTMLImageElement.width und HTMLImageElement.height der resultierenden Instanz wider. Die intrinsische Breite und Höhe des Bildes in CSS-Pixeln werden durch die Eigenschaften HTMLImageElement.naturalWidth und HTMLImageElement.naturalHeight widergespiegelt. Wenn im Konstruktor keine Größe angegeben wird, haben beide Eigenschaftspaare dieselben Werte.

Beispiele

const myImage = new Image(100, 200);
myImage.src = "picture.jpg";
document.body.appendChild(myImage);

Dies wäre gleichbedeutend mit der Definition des folgenden HTML-Tags innerhalb des <body>:

html

<img width="100" height="200" src="picture.jpg" />

Spezifikationen

Specification
HTML # dom-image-dev