CKTIS / JavaScript
Element.getBoundingClientRect(): dimenzije i položaj objekta DOMRect
Izmjeri granični pravokutnik elementa u CSS pikselima i razlikuj koordinate u odnosu na područje prikaza od koordinata dokumenta.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
const rect = element.getBoundingClientRect();
const { x, y, width, height, top, right, bottom, left } = rect;element.getBoundingClientRect() ne prima argumente i vraća objekt DOMRect. To je web API, a ne dio ECMAScripta. Za mjerenje je potrebno okruženje koje izračunava raspored DOM-a; dostupnost ovisi o izvršnom okruženju.
Za HTML element mjerenje se temelji na pravokutnicima sa stranicama paralelnima s osima koji odgovaraju njegovim CSS okvirima do vanjskog ruba obruba. Uključuje unutarnji razmak i obrub, uzima u obzir CSS transformacije i isključuje margine. Pojedinačne pravokutnike dohvati pomoću getClientRects(). Ako je popis prazan, kao kod display: none, sve su vrijednosti nula. Ako svaki pravokutnik ima širinu ili visinu jednaku nuli, metoda vraća prvi pravokutnik s popisa. U suprotnom vraća najmanji pravokutnik koji obuhvaća sve pravokutnike s popisa osim onih kojima su obje dimenzije jednake nuli. Za linijski element koji se proteže kroz više redaka rezultat može obuhvatiti i praznine između fragmenata. Sam pravokutnik ne dokazuje da je element vidljiv.
width i height dimenzije su pravokutnika. U ovom su rezultatu x i y jednaki vrijednostima left i top; right je left + width, a bottom je top + height. Koordinate se mjere od gornjeg lijevog kuta područja prikaza, a ne od najbližeg ruba, pa mogu biti negativne. Sve su vrijednosti u CSS pikselima i mogu imati decimalni dio.
U objektu DOMRect možeš mijenjati x, y, width i height; koordinate rubova izračunavaju se i dostupne su samo za čitanje. U ručno stvorenom pravokutniku s negativnim width ili height, x se može razlikovati od left ili y od top. Promjena rezultata ne mijenja element. Rezultat je snimka stanja: nakon promjene rasporeda ili pomicanja sadržaja ponovno izmjeri element ako trebaš aktualne vrijednosti.
Za gornji lijevi kut u koordinatama dokumenta upotrijebi rect.left + window.scrollX i rect.top + window.scrollY. Očitaj pomake u trenutku mjerenja. Time mijenjaš ishodište koordinata, ali ne poništavaš pomicanje sadržaja unutar ugniježđenog spremnika.
Primjeri
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Measuring an element</title>
</head>
<body>
<script>
(() => {
const box = document.createElement('div');
box.style.cssText = 'position: fixed; left: 24.5px; top: 16px; margin: 0; box-sizing: content-box; width: 104px; height: 44px; padding: 8px; border: 0;';
document.body.append(box);
try {
const rect = box.getBoundingClientRect();
const { x, y, width, height, top, right, bottom, left } = rect;
console.log(`x=${x}, y=${y}, width=${width}, height=${height}, top=${top}, right=${right}, bottom=${bottom}, left=${left}`);
box.style.left = '44.5px';
console.log(`previous x=${rect.x}, current x=${box.getBoundingClientRect().x}`);
} finally {
box.remove();
}
})();
</script>
</body>
</html>Rezultat
x=24.5, y=16, width=120, height=60, top=16, right=144.5, bottom=76, left=24.5 previous x=24.5, current x=44.5
Spremi primjer kao HTML datoteku, otvori je u pregledniku i pročitaj ispis u razvojnoj konzoli. Dimenzije uključuju unutarnji razmak na objema stranama svake osi; element nema obrub. Nakon premještanja elementa prethodni pravokutnik zadržava izvorni `x`; samo novo mjerenje daje novi `x`.
Povezane lekcije
- JavaScript · Lekcija 12 · Napredno · Verzija: 4