Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Ohraničující obdélník a odsazení klientské oblasti

Změř polohu a velikost prvku vzhledem k oblasti zobrazení a odliš tyto hodnoty od levého a horního odsazení jeho klientské oblasti.

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

Syntaxe

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

element.getBoundingClientRect() je metoda rozhraní Element bez argumentů. Vrací DOMRect určený podle obdélníků, které getClientRects() vrací pro rámečkové boxy po uplatnění transformací. Je-li seznam prázdný, jsou všechny hodnoty nulové. Má-li každý obdélník v seznamu nulovou šířku nebo výšku, metoda vrátí první obdélník ze seznamu. Jinak vrátí nejmenší obdélník rovnoběžný s osami, který obepíná obdélníky s nenulovou šířkou nebo výškou. Zahrnuje rámeček a vnitřní odsazení, nikoli vnější okraje. left a top jsou souřadnice vzhledem k levému hornímu rohu oblasti zobrazení; width a height jsou rozměry. Hodnoty jsou v pixelech CSS a mohou být necelé.

element.clientLeft a element.clientTop jsou vlastnosti pouze pro čtení, ne metody. Udávají celočíselná odsazení v pixelech CSS bez vlivu transformací: tloušťku levého, respektive horního rámečku, plus prostor zabraný případnou posuvnou lištou na téže straně. Svislá lišta může být vlevo například při rozložení zprava doleva. Vnitřní odsazení ani vnější okraj se nezapočítávají. Pro řádkový box nebo při absenci boxu CSS obě vlastnosti vracejí nulu.

DOMRect zachycuje stav v okamžiku měření. Pokud potřebuješ aktuální souřadnice, po posunu stránky nebo změně rozložení měř znovu. Pro souřadnice vůči dokumentu přičti window.scrollX k left a window.scrollY k top. clientLeft a clientTop nepoužívej jako souřadnice oblasti zobrazení ani k obecnému převodu souřadnic po transformaci. Jde o rozhraní webové platformy (CSSOM View), nikoli o součást ECMAScriptu 2024; dostupnost závisí na běhovém prostředí.

Příklady

<!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>

Výsledek

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

Otevři dokument HTML v prohlížeči při přiblížení stránky na 100 % a s hodnotou `devicePixelRatio` rovnou `1`. Výsledek najdeš v konzoli prohlížeče. Změna měřítka zdvojnásobí rozměry obdélníku a nepohne jeho levým horním rohem; odsazení zůstanou `3` a `5`.

Související lekce

  • JavaScript · Lekce 35 · Pokročilá · Verze: 4

Zdroje