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

CKTIS / JavaScript

Element.getBoundingClientRect(): rozměry a poloha DOMRect

Změř ohraničující obdélník prvku v pixelech CSS a rozliš souřadnice vzhledem k zobrazované oblasti od souřadnic dokumentu.

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

Syntaxe

const rect = element.getBoundingClientRect();
const { x, y, width, height, top, right, bottom, left } = rect;

element.getBoundingClientRect() nepřijímá žádné argumenty a vrací objekt DOMRect. Jde o webové API, nikoli o součást ECMAScriptu. Měření vyžaduje prostředí, které počítá rozvržení DOM; dostupnost závisí na běhovém prostředí.

U prvku HTML měření vychází z obdélníků se stranami rovnoběžnými s osami, které odpovídají jeho rámečkům CSS až po vnější okraj ohraničení. Zahrnuje vnitřní odsazení a ohraničení, zohledňuje transformace CSS a nezahrnuje vnější okraje. Jednotlivé obdélníky získáš pomocí getClientRects(). Pokud je seznam prázdný, například při display: none, jsou všechny hodnoty nulové. Má-li každý obdélník nulovou šířku nebo nulovou výšku, metoda vrátí první obdélník v seznamu. Jinak vrátí nejmenší obdélník, který obepíná všechny obdélníky v seznamu kromě těch, které mají oba rozměry nulové. U řádkového prvku na více řádcích může výsledek pokrývat i mezery mezi fragmenty. Samotný obdélník nedokazuje, že je prvek viditelný.

width a height udávají rozměry obdélníku. V tomto výsledku se x a y rovnají left a top; right je left + width a bottom je top + height. Souřadnice se měří od levého horního rohu zobrazované oblasti, nikoli od její nejbližší hrany, a mohou být záporné. Všechny hodnoty jsou v pixelech CSS a mohou mít desetinnou část.

V objektu DOMRect lze měnit x, y, width a height; souřadnice hran se z nich odvozují a jsou jen pro čtení. U ručně vytvořeného obdélníku se zápornou hodnotou width nebo height se může x lišit od left nebo y od top. Změna výsledku nezmění prvek. Výsledek zachycuje stav při měření: pokud po změně rozvržení nebo posunutí obsahu potřebuješ aktuální hodnoty, změř prvek znovu.

Pro levý horní roh v souřadnicích dokumentu použij rect.left + window.scrollX a rect.top + window.scrollY. Hodnoty posunu odečti v okamžiku měření. Tím změníš počátek souřadnic, ale nezrušíš posun obsahu uvnitř vnořeného kontejneru.

Příklady

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

Výsledek

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

Ulož příklad jako soubor HTML, otevři ho v prohlížeči a přečti si výstup ve vývojářské konzoli. Rozměry zahrnují vnitřní odsazení na obou stranách každé osy; prvek nemá ohraničení. Po přesunutí prvku si předchozí obdélník ponechá původní `x`; novou hodnotu `x` vrátí až další měření.

Související lekce

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

Zdroje