Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje