HTMLImageElement:naturalWidth 属性

基线 广泛可用

此功能已得到很好的确立,并且可在许多设备和浏览器版本中使用。它自以下时间起在浏览器中可用: 2015 年 7 月.

HTMLImageElement 接口的只读 naturalWidth 属性返回图像的内在(自然)、密度校正宽度,以 CSS 像素 为单位。

如果在没有任何限制其宽度的条件下绘制图像,则此宽度即为图像的宽度;如果您既没有为图像指定宽度,也没有将图像放置在限制或明确指定图像宽度的容器中,则此宽度即为图像的 CSS 像素宽度。

相应的 naturalHeight 方法返回图像的自然高度。

注意:大多数情况下,自然宽度是服务器发送的图像的实际宽度。然而,浏览器可以在将图像推送到渲染器之前对其进行修改。例如,Chrome 会降低低端设备上图像的分辨率。在这种情况下,naturalWidth 会将浏览器干预修改后的图像宽度视为自然宽度,并返回此值。

一个整数,表示图像的内在宽度,以 CSS 像素为单位。当没有为图像设置任何约束或特定值时,这就是图像自然绘制的宽度。此自然宽度已针对呈现它的设备的像素密度进行了校正,这与 width 的值不同。

如果内在宽度不可用——无论是由于图像未指定内在宽度,还是由于图像数据不可用而无法获取此信息,naturalWidth 都会返回 0。

示例

请参阅 HTMLImageElement.naturalHeight,了解显示图像的自然“密度调整”大小及其受页面 CSS 和其他因素影响的渲染大小的示例代码。

规范

规范
HTML 标准
# dom-img-naturalwidth-dev

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。