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