HTMLElement: offsetWidth 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 Eigenschaft HTMLElement.offsetWidth gibt die Layoutbreite eines Elements als Ganzzahl zurück.

Typischerweise ist offsetWidth eine Messung in Pixeln der CSS-Breite des Elements, einschließlich jeglicher Rahmen, Polsterung und vertikaler Scrollleisten (falls dargestellt). Sie schließt nicht die Breite von Pseudo-Elementen wie ::before oder ::after ein.

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.

Wert

Eine Ganzzahl, die dem offsetWidth-Pixelwert des Elements entspricht. Die Eigenschaft offsetWidth ist schreibgeschützt.

Hinweis: Diese Eigenschaft rundet den Wert zu einer Ganzzahl. Wenn Sie einen Bruchwert benötigen, verwenden Sie element.getBoundingClientRect().

Beispiele

Ein Beispiel eines Elements mit großen Polsterungen, Rahmen und Rändern. offsetWidth ist die Layoutbreite des Elements, einschließlich seiner Polsterung und Rahmen, aber ohne seinen Rand.

Spezifikationen

Specification
CSSOM View Module
# dom-htmlelement-offsetwidth

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch