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