Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Element.getBoundingClientRect(): granični pravokutnik elementa

Element.getBoundingClientRect() vraća DOMRect koji opisuje položaj i veličinu elementa u odnosu na prikazno područje. Mjerenje uključuje unutarnji razmak, obrube i CSS transformacije; rezultat je snimka trenutačnog stanja.

Verzija: 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 metoda je Web API-ja koja se poziva bez argumenata kao element.getBoundingClientRect(). Vraća DOMRect: x, y, width, height i rubove top, right, bottom, left. Koordinate su relativne u odnosu na prikazno područje i izražene u CSS pikselima; mogu biti decimalne.

Kod običnog CSS elementa mjerenje uključuje unutarnji razmak i obrube, ali ne i vanjske razmake. U obzir uzima transformacije elementa i njegovih predaka. Rotacija daje granični pravokutnik poravnat s osima, a ne sam rotirani oblik. getClientRects() vraća pravokutnike pojedinačnih fragmenata. Ako popis nije prazan i svaki pravokutnik ima širinu ili visinu jednaku nuli, getBoundingClientRect() vraća prvi pravokutnik s popisa. U ostalim slučajevima kada popis nije prazan vraća najmanji pravokutnik koji obuhvaća sve pravokutnike s popisa osim onih kojima su i širina i visina jednake nuli.

Rezultat se ne ažurira automatski: ponovno izmjerite nakon promjena rasporeda ili pomicanja stranice. Ako element nema okvir rasporeda, primjerice uz display: none, položaj i dimenzije iznose nula. Riječ je o geometriji, a ne o provjeri vidljivosti ili prekrivenosti.

Primjer stvara element, očitava njegove mjere i uklanja ga. width iznosi 124, a height iznosi 64 jer se unutarnji razmak i obrubi dodaju dimenzijama sadržaja.

Primjeri

(() => {
  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}

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori