HTMLImageElement: Image() constructor

فهرست فصل‌ها دانلود آرشیوناشر

MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونه‌کد

{{APIRef("HTML DOM")}}

The **Image()** constructor creates a new {{DOMxRef("HTMLImageElement")}} instance. It is functionally equivalent to {{DOMxRef("Document.createElement()", "document.createElement('img')")}}.

توجه: This function should not be confused with the CSS [image()](/en-US/docs/Web/CSS/Reference/Values/image/image) function.

Syntax

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

Parameters

  • width {{optional_inline}}
  • : The width of the image (i.e., the value for the [width](/en-US/docs/Web/HTML/Reference/Elements/img#width)

attribute).

  • height {{optional_inline}}
  • : The height of the image (i.e., the value for the [height](/en-US/docs/Web/HTML/Reference/Elements/img#height)

attribute).

Usage note

The entire bitmap is loaded regardless of the sizes specified in the constructor. The size specified in the constructor is reflected through the properties {{DOMxRef("HTMLImageElement.width")}} and {{DOMxRef("HTMLImageElement.height")}} of the resulting instance. The intrinsic width and height of the image in CSS pixels are reflected through the properties {{DOMxRef("HTMLImageElement.naturalWidth")}} and {{DOMxRef("HTMLImageElement.naturalHeight")}}. If no size is specified in the constructor both pairs of properties have the same values.

Examples

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

This would be the equivalent of defining the following HTML tag inside the {{HTMLElement("body")}}:

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

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}