WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

HTMLElement.offsetWidth — Layoutbreite eines Elements

HTMLElement.offsetWidth liefert die ganzzahlige Breite eines Elements in CSS-Pixeln. Sie umfasst Innenabstand und Rahmen, nicht aber Außenabstände. CSS-Transformationen werden ignoriert.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

element.offsetWidth

HTMLElement.offsetWidth ist eine schreibgeschützte Eigenschaft aus CSSOM View und keine ECMAScript-Funktion. Sie gibt einen ganzzahligen Wert in CSS-Pixeln zurück. Bei einer gewöhnlichen einzelnen Box umfasst sie den Inhalt, den Innenabstand, die Rahmen und den von einer vertikalen Bildlaufleiste belegten Platz, nicht jedoch die Außenabstände.

Genauer gesagt misst sie die Breite des achsenparallelen Begrenzungsrechtecks, das alle Fragmente der Hauptbox des Elements einschließlich ihrer Rahmen umschließt. Teilt ein Nachfahre auf Blockebene die Inline-Hauptbox des Elements, gehen auch die von diesem Nachfahren erzeugten Fragmente in die Messung ein, deren Breite und Höhe beide ungleich null sind. Transformationen des Elements und seiner Vorfahren werden ignoriert. Hat ein Element keine Box, etwa bei display: none, ist das Ergebnis 0.

Im Beispiel ergibt box-sizing: content-box den Wert 100 + 2 * 10 + 2 * 2 = 124. Weder margin: 30px noch transform: scale(2) ändern diesen Wert. Der Code erfordert ein Browser-Dokument; eine Node.js-Version allein belegt nicht, dass diese API unterstützt wird.

Beispiele

const box = document.createElement('div');
box.style.cssText = 'all: initial; display: block; position: fixed; box-sizing: content-box; width: 100px; height: 20px; padding: 10px; border: 2px solid; margin: 30px; overflow: hidden; transform: scale(2);';
document.body.append(box);
console.log(box.offsetWidth);
box.style.display = 'none';
console.log(box.offsetWidth);
box.remove();

Ergebnis

124
0

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen