Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Mjerenje visine graničnog pravokutnika elementa

`getBoundingClientRect()` mjeri geometriju elementa u odnosu na područje prikaza. `DOMRect.height` daje visinu dobivenog pravokutnika u CSS pikselima.

Verzija: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

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

Pozovi element.getBoundingClientRect() bez argumenata. Ta metoda instance sučelja Element vraća DOMRect na temelju popisa koji daje getClientRects(). Ako je popis prazan, vraća pravokutnik čija svojstva x, y, width i height imaju vrijednost 0. Ako svaki pravokutnik na popisu ima širinu ili visinu jednaku nuli, metoda vraća prvi pravokutnik, čija visina i dalje može biti različita od nule. U suprotnom vraća najmanji pravokutnik sa stranicama paralelnima s osima koji obuhvaća sve pravokutnike sa širinom ili visinom različitom od nule, uključujući one kojima je samo jedna dimenzija različita od nule. Koordinate poput top i left odnose se na područje prikaza i mogu se mijenjati pri pomicanju prikaza. Visina je dimenzija, a ne koordinata.

Očitaj rect.height bez zagrada. To je broj u CSS pikselima koji može imati decimalni dio. Za jednostavan HTML element s jednim okvirom mjera uključuje sadržaj, unutarnji razmak (padding) i obrub, ali ne i vanjske margine. U obzir uzima CSS transformacije pa se može razlikovati od CSS svojstva height i od cjelobrojne visine rasporeda offsetHeight. Ako element ne stvara nijedan CSS okvir, primjerice pri display: none, visina je 0.

Pravokutnik predstavlja stanje u trenutku poziva. Ponovi mjerenje nakon promjene rasporeda ili transformacije. Dodjela vrijednosti svojstvu rect.height mijenja samo objekt DOMRect, ne element; u DOMRectReadOnly svojstvo je samo za čitanje.

To je web API, a ne značajka ECMAScripta 2024. Mjerenje zahtijeva okruženje s podrškom za DOM i izračun rasporeda. Prije poziva provjeri rezultat querySelector(): pokušaj pozivanja metode na null izaziva TypeError umjesto da vrati visinu nula.

Primjeri

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

Spremi primjer kao HTML datoteku, otvori je u pregledniku i provjeri ispis u konzoli razvojnih alata. Spremljeni pravokutnik daje `54`; nakon `scaleY(0.5)` novo mjerenje daje `27`.

Povezane lekcije

  • JavaScript · Lekcija 11 · Napredno · Verzija: 4

Izvori