Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Prostokąt elementu i odsunięcia obszaru klienta

Zmierz położenie i rozmiar elementu względem obszaru widoku i odróżnij je od odsunięć obszaru klienta od lewej i górnej krawędzi elementu.

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

Składnia

element.getBoundingClientRect() // DOMRect
 element.clientLeft // integer Number
 element.clientTop // integer Number

element.getBoundingClientRect() to bezargumentowa metoda interfejsu Element. Zwraca DOMRect wyznaczony na podstawie prostokątów pól obramowania zwracanych przez getClientRects() po uwzględnieniu transformacji. Jeśli lista jest pusta, wszystkie wartości wynoszą zero. Jeśli każdy prostokąt na liście ma zerową szerokość lub wysokość, metoda zwraca pierwszy prostokąt z listy. W przeciwnym razie zwraca najmniejszy prostokąt o bokach równoległych do osi, który obejmuje prostokąty o niezerowej szerokości lub wysokości. Pomiar uwzględnia obramowanie i padding, ale nie margines. left i top są współrzędnymi względem lewego górnego rogu obszaru widoku, a width i height to wymiary. Wartości są podane w pikselach CSS i mogą być ułamkowe.

element.clientLeft i element.clientTop to właściwości tylko do odczytu, a nie metody. Zwracają całkowite odsunięcia w pikselach CSS, bez wpływu transformacji: grubość odpowiednio lewego i górnego obramowania oraz rozmiar miejsca zajętego przez pasek przewijania po tej samej stronie, jeśli taki występuje. Pionowy pasek po lewej może pojawić się np. przy układzie od prawej do lewej. Padding i margines nie wchodzą do pomiaru. Dla pola liniowego lub braku pola CSS obie właściwości zwracają zero.

DOMRect jest zapisem pomiaru, który nie aktualizuje się sam. Po przewinięciu lub zmianie układu zmierz ponownie, jeśli potrzebujesz aktualnych współrzędnych. Aby przeliczyć left i top na współrzędne względem dokumentu, dodaj odpowiednio window.scrollX i window.scrollY. Nie traktuj clientLeft i clientTop jako współrzędnych widoku ani jako ogólnego przelicznika po transformacji. To API platformy webowej (CSSOM View), a nie część ECMAScript 2024; dostępność zależy od środowiska.

Przykłady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Element geometry</title>
</head>
<body>
<script>
(() => {
  // Use a 1:1 ratio so the borders need no device-pixel rounding.
  if (window.devicePixelRatio !== 1) {
    throw new Error('Run at 100% page zoom with devicePixelRatio set to 1.');
  }

  const box = document.createElement('div');
  box.style.cssText = `
    position: fixed; left: 20px; top: 30px;
    box-sizing: border-box; width: 80px; height: 40px;
    border: solid black; border-width: 5px 2px 2px 3px;
    overflow: hidden; transform-origin: top left; transform: scale(2);
  `;
  document.body.append(box);
  try {
    const { left, top, width, height } = box.getBoundingClientRect();
    console.log(`rect: ${left}, ${top}, ${width}, ${height}`);
    console.log(`client: ${box.clientLeft}, ${box.clientTop}`);
  } finally {
    box.remove();
  }
})();
</script>
</body>
</html>

Wynik

rect: 20, 30, 160, 80
client: 3, 5

Otwórz dokument HTML w przeglądarce przy powiększeniu strony 100% i `devicePixelRatio` równym `1`. Odczytaj wynik w konsoli przeglądarki. Skalowanie podwaja wymiary prostokąta bez przesunięcia jego lewego górnego rogu; odsunięcia pozostają równe `3` i `5`.

Powiązane lekcje

  • JavaScript · Lekcja 35 · Zaawansowany · Wersja: 4

Źródła