CKTIS / JavaScript
Element.getBoundingClientRect(): ohraničujúci obdĺžnik prvku
Element.getBoundingClientRect() vracia DOMRect, ktorý opisuje polohu a veľkosť prvku vzhľadom na zobrazovaciu oblasť. Meranie zahŕňa vnútorné odsadenie, okraje a transformácie CSS; výsledok je momentka aktuálneho stavu.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
const rect = element.getBoundingClientRect();Element.getBoundingClientRect je metóda Web API, ktorá sa volá bez argumentov ako element.getBoundingClientRect(). Vracia DOMRect: x, y, width, height a hrany top, right, bottom, left. Súradnice sú vzhľadom na zobrazovaciu oblasť a udávajú sa v CSS pixeloch; môžu byť zlomkové.
Pri bežnom prvku CSS meranie zahŕňa vnútorné odsadenie a okraje, nie však vonkajšie odsadenie. Zohľadňuje transformácie prvku aj jeho predkov. Otočenie vytvorí ohraničujúci obdĺžnik zarovnaný s osami, nie samotný otočený tvar. getClientRects() vracia obdĺžniky jednotlivých fragmentov. Ak zoznam nie je prázdny a každý obdĺžnik má nulovú šírku alebo nulovú výšku, getBoundingClientRect() vráti prvý obdĺžnik zo zoznamu. V ostatných prípadoch, keď zoznam nie je prázdny, vráti najmenší obdĺžnik, ktorý zahŕňa všetky obdĺžniky zo zoznamu okrem tých, ktoré majú nulovú šírku aj výšku.
Výsledok sa neaktualizuje automaticky: po zmenách rozloženia alebo posunutí stránky meranie zopakujte. Ak prvok nemá rozlohový box, napríklad pri display: none, poloha a rozmery sú nulové. Ide o geometriu, nie o test viditeľnosti alebo zakrytia.
Príklad vytvorí prvok, načíta jeho namerané hodnoty a odstráni ho. width je 124 a height je 64, pretože k rozmerom obsahu sa pripočíta vnútorné odsadenie a okraje.
Príklady
(() => {
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();
}
})();Výsledok
{"x":20,"y":30,"width":124,"height":64}Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.