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

BCD tables only load in the browser

Siehe auch