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

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

Zdroje