CKTIS / JavaScript
Wewnętrzne wymiary elementu: clientWidth i clientHeight
`clientWidth` i `clientHeight` odczytują wewnętrzną szerokość i wysokość elementu w całkowitych pikselach CSS. Uwzględniają padding, ale nie obramowanie, marginesy ani miejsce zajęte przez paski przewijania.
Wersja: Current web platform; runtime support varies
Składnia
element.clientWidth
element.clientHeightclientWidth i clientHeight to właściwości Element tylko do odczytu. Bez nawiasów odczytasz szerokość i wysokość w całych pikselach CSS. To API CSSOM View, nie ECMAScript; wymaga DOM z obsługą układu.
Wynik obejmuje treść i padding, bez obramowania i marginesu. Paski zajmujące miejsce w układzie zmniejszają szerokość (pionowy) lub wysokość (poziomy). Brak pudełka (display: none) lub zwykły display: inline daje 0 × 0; inline-block podlega pomiarowi.
Wymiary obszaru układu (layout viewport) bez pasków odczytasz z document.documentElement w trybie standardowym, a z document.body w quirks mode.
scrollWidth i scrollHeight mierzą też treść poza widocznym obszarem. getBoundingClientRect() uwzględnia obramowanie i transformacje CSS oraz może zwrócić wymiary ułamkowe.
Przykłady
<!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>Wynik
144 × 76 0 × 0
Zapisz przykład jako plik HTML, otwórz go w przeglądarce i sprawdź konsolę. Pierwszy wiersz uwzględnia 12 px paddingu po lewej i prawej oraz 8 px u góry i u dołu, ale nie obramowanie ani margines. Po ustawieniu `display: none` oba pomiary wynoszą zero.
Powiązane lekcje
- JavaScript · Lekcja 27 · Średniozaawansowany · Wersja: 3