Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje