CKTIS / JavaScript
Innenmaße eines Elements: clientWidth und clientHeight
`clientWidth` und `clientHeight` liefern die innere Breite und Höhe eines Elements in ganzen CSS-Pixeln. Der Innenabstand zählt mit, Rahmen, Außenabstand und der von Scrollleisten belegte Platz dagegen nicht.
Version: Current web platform; runtime support varies
Syntax
element.clientWidth
element.clientHeightclientWidth und clientHeight sind schreibgeschützte Eigenschaften von Element. Lies Breite und Höhe in ganzen CSS-Pixeln ohne Klammern aus. Die Eigenschaften gehören zu CSSOM View, nicht zu ECMAScript, und brauchen ein DOM mit Layout.
Inhalt und padding zählen mit, Rahmen und Außenabstand nicht. Platz beanspruchende Scrollleisten mindern die Breite (vertikal) oder Höhe (horizontal). Ohne CSS-Box (display: none) und bei normalen Inline-Boxen ergibt sich 0 × 0; inline-block wird gemessen.
Den Layout-Viewport ohne Scrollleisten misst im Standardmodus document.documentElement, im Quirks-Modus document.body.
scrollWidth und scrollHeight erfassen auch überstehenden Inhalt. getBoundingClientRect() berücksichtigt Rahmen und CSS-Transformationen und kann nicht ganzzahlige Maße liefern.
Beispiele
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<title>clientWidth and clientHeight</title>
</head>
<body>
<script>
const box = document.createElement('div');
box.style.cssText = 'display: block; box-sizing: content-box; width: 120px; height: 60px; padding: 8px 12px; border: 3px solid; margin: 10px; overflow: hidden;';
document.body.append(box);
console.log(`${box.clientWidth} × ${box.clientHeight}`);
box.style.display = 'none';
console.log(`${box.clientWidth} × ${box.clientHeight}`);
box.remove();
</script>
</body>
</html>Ergebnis
144 × 76 0 × 0
Speichere das Beispiel als HTML-Datei, öffne es im Browser und prüfe die Konsole. Die erste Zeile berücksichtigt links und rechts je 12 px und oben und unten je 8 px Innenabstand, aber weder Rahmen noch Außenabstand. Nach `display: none` sind beide Maße null.
Zugehörige Lektionen
- JavaScript · Lektion 27 · Mittlere Stufe · Version: 3