Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.clientHeight

clientWidth 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

Źródła