HTMLImageElement: naturalWidth 屬性

Baseline 已廣泛支援

此特性已相當成熟，可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來，各瀏覽器均已提供此特性。

HTMLImageElement 介面的只讀 naturalWidth 屬性返回影像的內在（自然）、經過畫素密度校正後的寬度，單位是 CSS 畫素。

這是影像在沒有任何約束的情況下繪製時的寬度；如果您既沒有為影像指定寬度，也沒有將影像放置在限制或明確指定影像寬度的容器中，那麼這個值就是影像的 CSS 畫素寬度。

對應的 naturalHeight 方法返回影像的自然高度。

注意： 大多數情況下，自然寬度是伺服器傳送的影像的實際寬度。然而，瀏覽器可能會在將影像推送到渲染器之前修改它。例如，Chrome 會降低低端裝置的影像解析度。在這種情況下，naturalWidth 會將這種瀏覽器干預修改後的影像寬度視為自然寬度，並返回該值。

值

一個整數值，表示影像的內在寬度（以 CSS 畫素為單位）。這是在沒有為影像設定約束或特定值時，影像自然繪製的寬度。與 width 屬性的值不同，此自然寬度已根據其顯示裝置的畫素密度進行了校正。

如果內在寬度不可用——無論是由於影像未指定內在寬度，還是由於無法獲取此資訊所需的影像資料不可用——naturalWidth 返回 0。

請參閱 HTMLImageElement.naturalHeight 獲取示例程式碼，該程式碼以其自然的“密度調整”大小和受頁面 CSS 及其他因素影響的渲染大小顯示影像。

規範
HTML # dom-img-naturalwidth-dev

此頁面最後由 MDN 貢獻者於 2024 年 7 月 26 日修改。