Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Obuhvatni pravokutnik i odmaci klijentskog područja

Izmjeri položaj i veličinu elementa u odnosu na područje prikaza i razlikuj te vrijednosti od lijevog i gornjeg odmaka klijentskog područja.

Verzija: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

element.getBoundingClientRect() // DOMRect
 element.clientLeft // integer Number
 element.clientTop // integer Number

element.getBoundingClientRect() je metoda sučelja Element bez argumenata. Vraća DOMRect određen na temelju pravokutnika koje getClientRects() vraća za okvire obruba nakon primjene transformacija. Ako je popis prazan, sve su vrijednosti nula. Ako svaki pravokutnik na popisu ima širinu ili visinu jednaku nuli, metoda vraća prvi pravokutnik s popisa. U suprotnom vraća najmanji pravokutnik poravnat s osima koji obuhvaća pravokutnike sa širinom ili visinom različitom od nule. Obuhvaća unutarnji razmak i obrub, ali ne i vanjsku marginu. left i top koordinate su u odnosu na gornji lijevi kut područja prikaza; width i height su dimenzije. Vrijednosti su izražene u CSS pikselima i ne moraju biti cijeli brojevi.

element.clientLeft i element.clientTop svojstva su samo za čitanje, a ne metode. Daju cjelobrojne odmake u CSS pikselima, bez utjecaja transformacija: debljinu lijevog odnosno gornjeg obruba te prostor koji eventualna traka za pomicanje zauzima na istoj strani. Okomita traka može biti lijevo, primjerice u rasporedu zdesna nalijevo. Unutarnji razmak i margina ne računaju se. Oba svojstva vraćaju nulu za okvir unutar retka ili ako nema CSS okvira.

DOMRect bilježi stanje u trenutku mjerenja. Izmjeri ponovno nakon pomicanja prikaza ili promjene rasporeda ako trebaš ažurne koordinate. Za koordinate u odnosu na dokument dodaj window.scrollX vrijednosti left, a window.scrollY vrijednosti top. Nemoj koristiti clientLeft i clientTop kao koordinate područja prikaza ni kao opći način pretvorbe koordinata nakon transformacije. Ovi API-ji pripadaju web-platformi (CSSOM View), a ne ECMAScriptu 2024; dostupnost ovisi o izvršnom okruženju.

Primjeri

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Element geometry</title>
</head>
<body>
<script>
(() => {
  // Use a 1:1 ratio so the borders need no device-pixel rounding.
  if (window.devicePixelRatio !== 1) {
    throw new Error('Run at 100% page zoom with devicePixelRatio set to 1.');
  }

  const box = document.createElement('div');
  box.style.cssText = `
    position: fixed; left: 20px; top: 30px;
    box-sizing: border-box; width: 80px; height: 40px;
    border: solid black; border-width: 5px 2px 2px 3px;
    overflow: hidden; transform-origin: top left; transform: scale(2);
  `;
  document.body.append(box);
  try {
    const { left, top, width, height } = box.getBoundingClientRect();
    console.log(`rect: ${left}, ${top}, ${width}, ${height}`);
    console.log(`client: ${box.clientLeft}, ${box.clientTop}`);
  } finally {
    box.remove();
  }
})();
</script>
</body>
</html>

Rezultat

rect: 20, 30, 160, 80
client: 3, 5

Otvori HTML dokument u pregledniku uz zumiranje stranice od 100 % i vrijednost `devicePixelRatio` jednaku `1`. Očitaj rezultat u konzoli preglednika. Skaliranje udvostručuje dimenzije pravokutnika bez pomicanja njegova gornjeg lijevog kuta; odmaci ostaju `3` i `5`.

Povezane lekcije

  • JavaScript · Lekcija 35 · Napredno · Verzija: 4

Izvori