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

Ein Beispiel eines Elements mit großem Innenabstand, Rand und Abstand. offsetHeight ist die Layout-Höhe des Elements einschließlich seines Innenabstands und Randes, jedoch ohne den Abstand.

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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
offsetHeight

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch