CKTIS / JavaScript
Meranie výšky ohraničujúceho obdĺžnika prvku
`getBoundingClientRect()` meria geometriu prvku vzhľadom na zobrazovaciu oblasť. `DOMRect.height` udáva výšku získaného obdĺžnika v pixeloch CSS.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
const rect = element.getBoundingClientRect();
const height = rect.height;Zavolaj element.getBoundingClientRect() bez argumentov. Táto inštančná metóda rozhrania Element vráti DOMRect na základe zoznamu z getClientRects(). Ak je zoznam prázdny, vráti obdĺžnik, ktorého x, y, width a height majú hodnotu 0. Ak má každý obdĺžnik v zozname nulovú šírku alebo nulovú výšku, vráti prvý obdĺžnik, ktorý aj tak môže mať nenulovú výšku. V opačnom prípade vráti najmenší obdĺžnik so stranami rovnobežnými s osami, ktorý zahŕňa všetky obdĺžniky s nenulovou šírkou alebo výškou vrátane tých, ktoré majú len jeden nenulový rozmer. Súradnice ako top a left sa vzťahujú na zobrazovaciu oblasť a pri posúvaní sa môžu meniť. Výška je rozmer, nie súradnica.
Hodnotu rect.height čítaj bez zátvoriek. Je to číslo v pixeloch CSS, ktoré môže mať desatinnú časť. Pri jednoduchom prvku HTML s jedným boxom meranie zahŕňa obsah, vnútorné odsadenie (padding) a orámovanie, ale nie vonkajšie okraje. Zohľadňuje transformácie CSS, preto sa môže líšiť od vlastnosti CSS height aj od celočíselnej výšky rozloženia offsetHeight. Ak prvok nevytvára žiadny box CSS, napríklad pri display: none, výška je 0.
Obdĺžnik zachytáva stav v okamihu volania. Po zmene rozloženia alebo transformácie meraj znova. Priradenie hodnoty do rect.height zmení iba objekt DOMRect, nie prvok; v DOMRectReadOnly je vlastnosť iba na čítanie.
Ide o webové API, nie o súčasť ECMAScriptu 2024. Meranie vyžaduje prostredie s podporou DOM a výpočtu rozloženia. Pred volaním skontroluj výsledok querySelector(): pokus o volanie metódy na null vyvolá TypeError namiesto vrátenia nulovej výšky.
Prí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ýsledok
54 27
Ulož príklad ako súbor HTML, otvor ho v prehliadači a skontroluj výstup v konzole vývojárskych nástrojov. Uložený obdĺžnik udáva `54`; po `scaleY(0.5)` nové meranie udáva `27`.
Súvisiace lekcie
- JavaScript · Lekcia 11 · Pokročilá · Verzia: 4