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