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 HTMLImageElement Instanz. Er ist funktional äquivalent zu document.createElement('img').

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

Syntax

js
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).

Verwendungshinweis

Das gesamte Bitmap wird unabhängig von den im Konstruktor angegebenen Größen geladen. Die im Konstruktor angegebene Größe wird durch die Eigenschaften HTMLImageElement.width und HTMLImageElement.height der resultierenden Instanz widergespiegelt. 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 Paare von Eigenschaften die gleichen Werte.

Beispiele

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

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

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

Spezifikationen

Specification
HTML Standard
# dom-image-dev

Browser-Kompatibilität

BCD tables only load in the browser