CKTIS / JavaScript
Element.getBoundingClientRect(): mere in položaj objekta DOMRect
Izmeri omejevalni pravokotnik elementa v slikovnih pikah CSS in loči koordinate glede na vidno polje od koordinat dokumenta.
Različica: 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 sprejme argumentov in vrne objekt DOMRect. To je spletni API, ne del ECMAScripta. Za merjenje potrebuješ okolje, ki izračunava postavitev DOM; razpoložljivost je odvisna od izvajalnega okolja.
Pri elementu HTML meritev temelji na pravokotnikih s stranicami, vzporednimi z osema, ki ustrezajo okvirjem CSS do zunanjega roba obrobe. Vključuje notranji odmik in obrobo, upošteva transformacije CSS in izključuje zunanje odmike. Za posamezne pravokotnike uporabi getClientRects(). Če je seznam prazen, na primer pri display: none, so vse vrednosti nič. Če ima vsak pravokotnik širino ali višino nič, metoda vrne prvi pravokotnik s seznama. Sicer vrne najmanjši pravokotnik, ki zajema vse pravokotnike s seznama razen tistih, katerih obe meri sta nič. Če je vrstični element razdeljen med več vrstic, lahko rezultat zajame tudi vrzeli med fragmenti. Sam pravokotnik ne dokazuje, da je element viden.
width in height sta meri pravokotnika. V tem rezultatu sta x in y enaka left in top; right je left + width, bottom pa top + height. Koordinate se merijo od zgornjega levega kota vidnega polja, ne od najbližjega roba, zato so lahko negativne. Vse vrednosti so v slikovnih pikah CSS in imajo lahko decimalni del.
V objektu DOMRect lahko nastaviš x, y, width in height; koordinate robov se izračunajo in so le za branje. Če pri ročno ustvarjenem pravokotniku nastaviš negativno vrednost width ali height, se lahko x razlikuje od left ali y od top. Spreminjanje rezultata ne spremeni elementa. Rezultat je posnetek stanja: po spremembi postavitve ali pomiku vsebine znova izmeri element, če potrebuješ aktualne vrednosti.
Za zgornji levi kot v dokumentu uporabi rect.left + window.scrollX in rect.top + window.scrollY. Odmika zaradi pomika preberi ob merjenju. S tem spremeniš koordinatno izhodišče, ne izničiš pa pomika znotraj ugnezdenega vsebnika.
Primeri
<!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
Shrani primer kot datoteko HTML, odpri jo v brskalniku in preberi izpis v konzoli za razvijalce. Mere vključujejo notranji odmik na obeh straneh vsake osi; element nima obrobe. Po premiku elementa prejšnji pravokotnik ohrani prvotni `x`; novo vrednost `x` da šele nova meritev.
Povezane lekcije
- JavaScript · Lekcija 12 · Napredna · Različica: 4