HTMLElement: offsetHeight 屬性

Baseline 已廣泛支援

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

HTMLElement 介面的只讀屬性 offsetHeight 返回元素的總高度,包括垂直內邊距和邊框,以整數形式表示。

通常,offsetHeight 是元素 CSS 高度的畫素測量值,包括任何邊框、內邊距和水平捲軸(如果已渲染)。它不包括偽元素(如 ::before::after)的高度。對於文件的 body 物件,該測量值包含總的線性內容高度,而不是元素的 CSS 高度。延伸到其他線性內容下方的浮動元素將被忽略。

如果元素被隱藏(例如,透過將元素或其祖先的 style.display 設定為 "none"),則返回 0

一個整數。

示例

An example element with large padding, border and margin. offsetHeight is the layout height of the element including its padding and border, and excluding its margin.

上面的示例影像顯示了一個捲軸和一個適合視窗的 offsetHeight。然而,非滾動元素可能具有很大的 offsetHeight 值,遠大於可見內容。這些元素通常包含在可滾動元素中;因此,這些非滾動元素可能完全或部分不可見,具體取決於可滾動容器的 scrollTop 設定。

規範

規範
CSSOM 檢視模組
# dom-htmlelement-offsetheight

瀏覽器相容性

另見