Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła