Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Pomiar wysokości prostokąta ograniczającego element

Metoda `getBoundingClientRect()` mierzy geometrię elementu względem obszaru widoku. Właściwość `DOMRect.height` podaje wysokość prostokąta w pikselach CSS.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

const rect = element.getBoundingClientRect();
const height = rect.height;

Wywołaj element.getBoundingClientRect() bez argumentów. Metoda instancji Element zwraca DOMRect na podstawie listy z getClientRects(). Jeśli lista jest pusta, zwraca prostokąt, którego x, y, width i height wynoszą 0. Jeśli każdy prostokąt na liście ma zerową szerokość lub zerową wysokość, metoda zwraca pierwszy prostokąt, który nadal może mieć niezerową wysokość. W przeciwnym razie zwraca najmniejszy prostokąt o bokach równoległych do osi, który obejmuje wszystkie prostokąty o niezerowej szerokości lub wysokości, także te, w których tylko jeden wymiar jest niezerowy. Współrzędne, takie jak top i left, są podane względem obszaru widoku i mogą się zmieniać przy przewijaniu. Wysokość jest wymiarem, a nie współrzędną.

Odczytaj rect.height bez nawiasów. To liczba w pikselach CSS, która może mieć część ułamkową. W prostym elemencie HTML z jedną ramką pomiar obejmuje zawartość, wewnętrzne odstępy (padding) i obramowanie, ale nie marginesy. Uwzględnia transformacje CSS, więc może się różnić od wysokości zadanej w CSS i od całkowitoliczbowej wysokości układu offsetHeight. Jeśli element nie generuje żadnej ramki CSS, na przykład przy display: none, wysokość wynosi 0.

Wynik to migawka z chwili wywołania. Aby poznać aktualne wymiary po zmianie układu lub transformacji, zmierz element ponownie. Zapis do rect.height zmienia tylko obiekt DOMRect, nie element; w DOMRectReadOnly ta właściwość jest tylko do odczytu.

To API platformy webowej, a nie funkcja ECMAScript 2024. Do pomiaru potrzebne jest środowisko z DOM i mechanizmem układu. Przed wywołaniem sprawdź wynik querySelector(): próba wywołania metody na null powoduje TypeError, a nie pomiar równy zeru.

Przykłady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Bounding rectangle height</title>
</head>
<body>
  <script>
    const box = document.createElement('div');
    box.style.cssText = 'box-sizing: content-box; width: 100px; height: 44px; padding: 5px; border: 0;';
    document.body.append(box);

    const before = box.getBoundingClientRect();
    box.style.transform = 'scaleY(0.5)';

    console.log(before.height);
    console.log(box.getBoundingClientRect().height);
    box.remove();
  </script>
</body>
</html>

Wynik

54
27

Zapisz przykład jako plik HTML, otwórz go w przeglądarce i sprawdź konsolę narzędzi deweloperskich. Zapisany prostokąt podaje `54`; po `scaleY(0.5)` nowy pomiar daje `27`.

Powiązane lekcje

  • JavaScript · Lekcja 11 · Zaawansowany · Wersja: 4

Źródła