HTMLImageElement:naturalWidth 属性
该 HTMLImageElement
接口的只读 naturalWidth
属性返回图像的内在(自然)、密度校正宽度,以 CSS 像素 为单位。
如果在没有任何限制其宽度的条件下绘制图像,则此宽度即为图像的宽度;如果您既没有为图像指定宽度,也没有将图像放置在限制或明确指定图像宽度的容器中,则此宽度即为图像的 CSS 像素宽度。
相应的 naturalHeight
方法返回图像的自然高度。
注意:大多数情况下,自然宽度是服务器发送的图像的实际宽度。然而,浏览器可以在将图像推送到渲染器之前对其进行修改。例如,Chrome 会降低低端设备上图像的分辨率。在这种情况下,naturalWidth
会将浏览器干预修改后的图像宽度视为自然宽度,并返回此值。
值
一个整数,表示图像的内在宽度,以 CSS 像素为单位。当没有为图像设置任何约束或特定值时,这就是图像自然绘制的宽度。此自然宽度已针对呈现它的设备的像素密度进行了校正,这与 width
的值不同。
如果内在宽度不可用——无论是由于图像未指定内在宽度,还是由于图像数据不可用而无法获取此信息,naturalWidth
都会返回 0。
示例
请参阅 HTMLImageElement.naturalHeight
,了解显示图像的自然“密度调整”大小及其受页面 CSS 和其他因素影响的渲染大小的示例代码。
规范
规范 |
---|
HTML 标准 # dom-img-naturalwidth-dev |
浏览器兼容性
BCD 表格仅在启用 JavaScript 的浏览器中加载。