HTMLElement: offsetHeight-Eigenschaft
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Die schreibgeschützte HTMLElement.offsetHeight
-Eigenschaft gibt
die Höhe eines Elements zurück, einschließlich vertikaler Innenabstände und Ränder, als Ganzzahl.
Typischerweise ist offsetHeight
eine Messung in Pixeln der CSS-Höhe des Elements, einschließlich aller Ränder, Innenabstände und horizontaler Scrollbars (falls angezeigt). Es schließt nicht die Höhe von Pseudo-Elementen wie ::before
oder ::after
ein. Für das Dokument-Bodenelement umfasst die Messung die gesamte lineare Inhaltshöhe anstelle der CSS-Höhe des Elements. Schwebende Elemente, die sich unter anderem linearen Inhalt erstrecken, werden ignoriert.
Wenn das Element verborgen ist (zum Beispiel, indem style.display
auf dem
Element oder einem seiner Vorfahren auf "none"
gesetzt wird), wird 0
zurückgegeben.
Hinweis:
Diese Eigenschaft rundet den Wert auf eine Ganzzahl. Wenn Sie einen gebrochenen Wert benötigen, verwenden Sie element.getBoundingClientRect()
.
Wert
Eine Zahl.
Beispiele
Das obige Beispielbild zeigt eine Scrollbar und ein offsetHeight
, das in das Fenster passt. Nicht scrollbare Elemente können jedoch große offsetHeight
-Werte aufweisen, die deutlich größer als der sichtbare Inhalt sind. Diese Elemente befinden sich typischerweise in scrollbaren Elementen; infolgedessen können diese nicht scrollbaren Elemente je nach scrollTop
-Einstellung des scrollbaren Containers vollständig oder teilweise unsichtbar sein.
Spezifikationen
Specification |
---|
CSSOM View Module # dom-htmlelement-offsetheight |
Browser-Kompatibilität
BCD tables only load in the browser