HTMLImageElement: Image() 构造函数

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

Image() 构造函数创建一个新的 HTMLImageElement 实例。它在功能上等同于 document.createElement('img')

注意: 这个函数不应与 CSS 中的 image() 函数混淆。

语法

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

参数

width 可选

图像的宽度(即 width 属性的值)。

height 可选

图像的高度(即 height 属性的值)。

用法说明

无论在构造函数中指定了什么尺寸,整个位图都会被加载。构造函数中指定的尺寸会通过所得实例的 HTMLImageElement.widthHTMLImageElement.height 属性体现。图像的 CSS 像素的固有宽度和高度通过 HTMLImageElement.naturalWidthHTMLImageElement.naturalHeight 属性体现。如果在构造函数中没有指定尺寸,那么这两对属性将具有相同的值。

示例

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

这相当于在 <body> 中定义了以下 HTML 标签:

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

规范

规范
HTML
# dom-image-dev

浏览器兼容性