CKTIS / JavaScript
Element.getBoundingClientRect(): wymiary i położenie DOMRect
Zmierz prostokąt ograniczający element w pikselach CSS i odróżnij współrzędne względem obszaru widoku od współrzędnych dokumentu.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
const rect = element.getBoundingClientRect();
const { x, y, width, height, top, right, bottom, left } = rect;element.getBoundingClientRect() nie przyjmuje argumentów i zwraca obiekt DOMRect. To interfejs platformy webowej, a nie część ECMAScriptu. Do pomiaru potrzebujesz środowiska z DOM i mechanizmem układu; dostępność zależy od środowiska uruchomieniowego.
Dla elementu HTML podstawą pomiaru są prostokąty o bokach równoległych do osi, odpowiadające jego ramkom CSS. Pomiar uwzględnia padding, obramowanie i przekształcenia CSS, ale nie marginesy. Poszczególne prostokąty odczytasz przez getClientRects(). Gdy lista jest pusta, np. przy display: none, wszystkie wartości wynoszą zero. Jeśli każdy prostokąt ma zerową szerokość lub zerową wysokość, metoda zwraca pierwszy prostokąt z listy. W przeciwnym razie zwraca najmniejszy prostokąt obejmujący wszystkie prostokąty z listy poza tymi, które mają oba wymiary zerowe. Dla elementu śródliniowego rozbitego na kilka wierszy wynik może obejmować przerwy między fragmentami. Sam prostokąt nie dowodzi, że element jest widoczny.
width i height to wymiary prostokąta. x i y są w tym wyniku równe left i top; right to left + width, a bottom to top + height. Współrzędne liczy się od lewego górnego narożnika obszaru widoku, a nie od jego najbliższej krawędzi: mogą być ujemne. Wszystkie wartości są w pikselach CSS i mogą być ułamkowe.
W DOMRect można zmienić x, y, width i height; krawędzie są wyliczane i dostępne tylko do odczytu. W prostokącie utworzonym ręcznie ujemne width lub height może sprawić, że x nie będzie równe left lub y nie będzie równe top. Modyfikacja wyniku nie zmienia elementu. Wynik to zapis pomiaru, który nie aktualizuje się sam: po zmianie układu lub przewinięciu zmierz ponownie, jeśli potrzebujesz aktualnych danych.
Aby przeliczyć lewy górny narożnik na współrzędne dokumentu, użyj rect.left + window.scrollX i rect.top + window.scrollY, odczytując przesunięcia w momencie pomiaru. To zmienia układ odniesienia, ale nie cofa skutków przewijania zagnieżdżonego kontenera.
Przykłady
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Measuring an element</title>
</head>
<body>
<script>
(() => {
const box = document.createElement('div');
box.style.cssText = 'position: fixed; left: 24.5px; top: 16px; margin: 0; box-sizing: content-box; width: 104px; height: 44px; padding: 8px; border: 0;';
document.body.append(box);
try {
const rect = box.getBoundingClientRect();
const { x, y, width, height, top, right, bottom, left } = rect;
console.log(`x=${x}, y=${y}, width=${width}, height=${height}, top=${top}, right=${right}, bottom=${bottom}, left=${left}`);
box.style.left = '44.5px';
console.log(`previous x=${rect.x}, current x=${box.getBoundingClientRect().x}`);
} finally {
box.remove();
}
})();
</script>
</body>
</html>Wynik
x=24.5, y=16, width=120, height=60, top=16, right=144.5, bottom=76, left=24.5 previous x=24.5, current x=44.5
Zapisz przykład jako plik HTML, otwórz go w przeglądarce i odczytaj wynik w konsoli. Wymiary obejmują `padding` po obu stronach każdej osi; element nie ma obramowania. Po przesunięciu elementu poprzedni prostokąt zachowuje pierwotne `x`; nowe `x` daje dopiero kolejny pomiar.
Powiązane lekcje
- JavaScript · Lekcja 12 · Zaawansowany · Wersja: 4