Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Merjenje višine omejitvenega pravokotnika elementa

`getBoundingClientRect()` izmeri geometrijo elementa glede na prikazno območje. `DOMRect.height` poda višino dobljenega pravokotnika v slikovnih pikah CSS.

Različica: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

const rect = element.getBoundingClientRect();
const height = rect.height;

Pokliči element.getBoundingClientRect() brez argumentov. Ta metoda primerka vmesnika Element vrne DOMRect na podlagi seznama, ki ga vrne getClientRects(). Če je seznam prazen, vrne pravokotnik, v katerem imajo x, y, width in height vrednost 0. Če ima vsak pravokotnik na seznamu širino ali višino nič, vrne prvi pravokotnik, katerega višina je še vedno lahko različna od nič. Sicer vrne najmanjši pravokotnik s stranicami, vzporednimi z osema, ki zajame vse pravokotnike z neničelno širino ali višino, tudi tiste, ki imajo samo eno neničelno mero. Koordinate, kot sta top in left, so podane glede na prikazno območje in se lahko med drsenjem spremenijo. Višina je mera, ne koordinata.

Preberi rect.height brez oklepajev. Vrednost je število v slikovnih pikah CSS in ima lahko decimalni del. Pri preprostem elementu HTML z enim okvirjem meritev vključuje vsebino, notranji odmik (padding) in obrobo, ne pa zunanjih odmikov. Upošteva transformacije CSS, zato se lahko razlikuje od lastnosti CSS height in od celoštevilske višine postavitve offsetHeight. Če element ne ustvari nobenega okvirja CSS, denimo pri display: none, je višina 0.

Pravokotnik predstavlja stanje ob klicu. Po spremembi postavitve ali transformacije izmeri znova. Prirejanje vrednosti lastnosti rect.height spremeni samo objekt DOMRect, ne elementa; pri DOMRectReadOnly je lastnost samo za branje.

To je spletni API, ne del ECMAScripta 2024. Merjenje zahteva okolje s podporo za DOM in izračun postavitve. Pred klicem preveri rezultat querySelector(): poskus klica metode na null sproži TypeError, namesto da bi vrnil ničelno višino.

Primeri

<!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>

Rezultat

54
27

Shrani primer kot datoteko HTML, odpri jo v brskalniku in preveri izpis v konzoli orodij za razvijalce. Shranjeni pravokotnik vrne `54`; po `scaleY(0.5)` nova meritev vrne `27`.

Povezane lekcije

  • JavaScript · Lekcija 11 · Napredna · Različica: 4

Viri