CKTIS / JavaScript
Element.getBoundingClientRect(): omejitveni pravokotnik elementa
Element.getBoundingClientRect() vrne DOMRect, ki opisuje položaj in velikost elementa glede na vidno polje. Meritev vključuje notranji odmik, obrobe in transformacije CSS; rezultat je trenutni posnetek.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
const rect = element.getBoundingClientRect();Element.getBoundingClientRect je metoda spletnega API-ja, ki jo brez argumentov pokličemo kot element.getBoundingClientRect(). Vrne DOMRect: x, y, width, height in robove top, right, bottom, left. Koordinate so glede na vidno polje in izražene v slikovnih pikah CSS; lahko so decimalne.
Pri običajnem elementu CSS meritev vključuje notranji odmik in obrobe, ne pa zunanjih odmikov. Upošteva transformacije elementa in njegovih prednikov. Zasuk ustvari z osmi poravnan omejitveni pravokotnik, ne pa same zasukane oblike. getClientRects() vrne pravokotnike posameznih fragmentov. Če seznam ni prazen in ima vsak pravokotnik širino nič ali višino nič, getBoundingClientRect() vrne prvi pravokotnik na seznamu. V drugih primerih, ko seznam ni prazen, vrne najmanjši pravokotnik, ki zajema vse pravokotnike s seznama razen tistih, pri katerih sta tako širina kot višina enaki nič.
Rezultat se ne posodablja samodejno: po spremembah postavitve ali pomikanju izvedite novo meritev. Če element nima postavitvenega polja, na primer pri display: none, sta položaj in velikost enaka nič. To so geometrijski podatki, ne preverjanje vidnosti ali prekrivanja.
Primer ustvari element, prebere njegovo meritev in ga odstrani. width je 124, height pa 64, ker se notranji odmik in obrobe prištejejo meram vsebine.
Primeri
(() => {
const box = document.createElement('div');
box.style.cssText = 'all: initial; display: block; position: fixed; left: 20px; top: 30px; box-sizing: content-box; width: 100px; height: 40px; padding: 10px; border: 2px solid black; margin: 0;';
document.body.append(box);
try {
const rect = box.getBoundingClientRect();
console.log(JSON.stringify({
x: rect.x,
y: rect.y,
width: rect.width,
height: rect.height
}));
} finally {
box.remove();
}
})();Rezultat
{"x":20,"y":30,"width":124,"height":64}Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.