Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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

Zdroje