Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Element.getBoundingClientRect(): prostokąt ograniczający element

Element.getBoundingClientRect() zwraca DOMRect opisujący położenie i rozmiar elementu względem obszaru widoku. Pomiar obejmuje padding, obramowanie i transformacje CSS; wynik jest migawką.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

const rect = element.getBoundingClientRect();

Element.getBoundingClientRect to metoda Web API wywoływana jako element.getBoundingClientRect(), bez argumentów. Zwraca DOMRect: x, y, width, height oraz krawędzie top, right, bottom, left. Współrzędne są względem obszaru widoku, w pikselach CSS; mogą być ułamkowe.

Dla zwykłego elementu CSS pomiar obejmuje padding i obramowanie, ale nie margines. Uwzględnia transformacje elementu i przodków. Obrót daje prostokąt ograniczający równoległy do osi, a nie sam obrócony kształt. getClientRects() zwraca prostokąty poszczególnych fragmentów. Jeśli lista nie jest pusta i każdy prostokąt ma zerową szerokość lub zerową wysokość, getBoundingClientRect() zwraca pierwszy prostokąt z listy. W pozostałych przypadkach, gdy lista nie jest pusta, zwraca najmniejszy prostokąt obejmujący wszystkie prostokąty z listy z wyjątkiem tych, których szerokość i wysokość wynoszą zero.

Wynik nie aktualizuje się automatycznie: po zmianach układu lub przewinięciu wykonaj pomiar ponownie. Brak pudełka układu, np. przy display: none, daje zerowe położenie i wymiary. To geometria, nie test widoczności ani zasłonięcia.

Przykład tworzy element, odczytuje pomiar i usuwa element. width wynosi 124, a height wynosi 64, ponieważ do wymiarów treści dochodzą padding i obramowanie.

Przykłady

(() => {
  const box = document.createElement('div');
  box.style.cssText = 'all: initial; display: block; position: fixed; left: 20px; top: 30px; box-sizing: content-box; width: 100px; height: 40px; padding: 10px; border: 2px solid black; margin: 0;';
  document.body.append(box);
  try {
    const rect = box.getBoundingClientRect();
    console.log(JSON.stringify({
      x: rect.x,
      y: rect.y,
      width: rect.width,
      height: rect.height
    }));
  } finally {
    box.remove();
  }
})();

Wynik

{"x":20,"y":30,"width":124,"height":64}

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła