Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

HTMLImageElement : constructeur Image()

Baseline Widely available

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

Le constructeur Image() crée une nouvelle instance HTMLImageElement. C'est fonctionnellement équivalent à document.createElement('img').

Note : Cette fonction ne doit pas être confondue avec la fonction CSS image().

Syntaxe

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

Paramètres

width Facultatif

La largeur de l'image (c'est-à-dire, la valeur pour l'attribut width)

height Facultatif

La hauteur de l'image (c'est-à-dire, la valeur pour l'attribut height).

Notes d'utilisation

L'intégralité du bitmap est chargée, quelle que soit la taille spécifiée dans le constructeur. La taille spécifiée dans le constructeur est reflétée par les propriétés HTMLImageElement.width et HTMLImageElement.height de l'instance résultante. La largeur et la hauteur intrinsèques de l'image en pixels CSS sont reflétées par les propriétés HTMLImageElement.naturalWidth et HTMLImageElement.naturalHeight. Si aucune taille n'est spécifiée dans le constructeur, les deux paires de propriétés auront les mêmes valeurs.

Exemples

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

Cela équivaut à définir la balise HTML suivante dans le <body> :

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

Spécifications

Specification
HTML
# dom-image-dev

Compatibilité des navigateurs