CKTIS / JavaScript
Element.getBoundingClientRect(): ohraničující obdélník prvku
Element.getBoundingClientRect() vrací DOMRect, který popisuje polohu a velikost prvku vzhledem k zobrazované oblasti. Měření zahrnuje vnitřní odsazení, okraje a transformace CSS; výsledek je snímek aktuálního stavu.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
const rect = element.getBoundingClientRect();Element.getBoundingClientRect je metoda Web API, která se volá bez argumentů jako element.getBoundingClientRect(). Vrací DOMRect: x, y, width, height a hrany top, right, bottom, left. Souřadnice jsou vzhledem k zobrazované oblasti a udávají se v CSS pixelech; mohou být zlomkové.
U běžného prvku CSS měření zahrnuje vnitřní odsazení a okraje, nikoli však vnější odsazení. Zohledňuje transformace prvku i jeho předků. Otočení vytvoří ohraničující obdélník zarovnaný s osami, nikoli samotný otočený tvar. getClientRects() vrací obdélníky jednotlivých fragmentů. Pokud seznam není prázdný a každý obdélník má nulovou šířku nebo nulovou výšku, getBoundingClientRect() vrátí první obdélník ze seznamu. V ostatních případech, kdy seznam není prázdný, vrátí nejmenší obdélník, který zahrnuje všechny obdélníky ze seznamu kromě těch, které mají nulovou šířku i výšku.
Výsledek se neaktualizuje automaticky: po změnách rozvržení nebo posunutí stránky měření zopakujte. Pokud prvek nemá rozvrhovací box, například při display: none, jsou poloha a rozměry nulové. Jde o geometrii, nikoli o test viditelnosti nebo zakrytí.
Příklad vytvoří prvek, načte jeho naměřené hodnoty a odstraní ho. width je 124 a height je 64, protože se k rozměrům obsahu přičítá vnitřní odsazení a okraje.
Pří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ýsledek
{"x":20,"y":30,"width":124,"height":64}Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.