CKTIS / JavaScript
Měření výšky ohraničujícího obdélníku prvku
`getBoundingClientRect()` změří geometrii prvku vzhledem k zobrazovací oblasti. `DOMRect.height` udává výšku získaného obdélníku v pixelech CSS.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
const rect = element.getBoundingClientRect();
const height = rect.height;Zavolej element.getBoundingClientRect() bez argumentů. Tato instanční metoda rozhraní Element vrací DOMRect na základě seznamu z getClientRects(). Je-li seznam prázdný, vrátí obdélník s hodnotou 0 ve všech čtyřech vlastnostech x, y, width a height. Má-li každý obdélník v seznamu nulovou šířku nebo nulovou výšku, vrátí první obdélník, který přesto může mít nenulovou výšku. Jinak vrátí nejmenší obdélník se stranami rovnoběžnými s osami, který obepíná všechny obdélníky s nenulovou šířkou nebo výškou, včetně těch, které mají jen jeden nenulový rozměr. Souřadnice jako top a left se vztahují k zobrazovací oblasti a při posouvání se mohou měnit. Výška je rozměr, nikoli souřadnice.
Hodnotu rect.height čti bez závorek. Jde o číslo v pixelech CSS, které může mít desetinnou část. U jednoduchého prvku HTML s jedním boxem měření zahrnuje obsah, vnitřní odsazení (padding) a rámečky, ale ne vnější okraje. Zohledňuje transformace CSS, a může se proto lišit od vlastnosti CSS height i od celočíselné výšky rozvržení offsetHeight. Pokud prvek nevytváří žádný box CSS, například při display: none, je výška 0.
Obdélník zachycuje stav v okamžiku volání. Po změně rozvržení nebo transformace měř znovu. Přiřazení do rect.height změní jen objekt DOMRect, ne prvek; v DOMRectReadOnly je vlastnost pouze pro čtení.
Jde o webové API, ne o funkci ECMAScriptu 2024. Měření vyžaduje prostředí s podporou DOM a výpočtu rozvržení. Před voláním zkontroluj výsledek querySelector(): pokus o volání metody na null vyvolá TypeError, místo aby vrátil nulovou výšku.
Příklady
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Bounding rectangle height</title>
</head>
<body>
<script>
const box = document.createElement('div');
box.style.cssText = 'box-sizing: content-box; width: 100px; height: 44px; padding: 5px; border: 0;';
document.body.append(box);
const before = box.getBoundingClientRect();
box.style.transform = 'scaleY(0.5)';
console.log(before.height);
console.log(box.getBoundingClientRect().height);
box.remove();
</script>
</body>
</html>Výsledek
54 27
Ulož příklad jako soubor HTML, otevři ho v prohlížeči a zkontroluj výstup ve vývojářské konzoli. Uložený obdélník udává `54`; po `scaleY(0.5)` nové měření udává `27`.
Související lekce
- JavaScript · Lekce 11 · Pokročilá · Verze: 4