Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Očrtovalni pravokotnik in odmiki odjemalskega območja

Izmeri položaj in velikost elementa glede na vidno polje ter loči ti meritvi od levega in zgornjega odmika njegovega odjemalskega območja.

Različica: 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 vmesnika Element brez argumentov. Vrne DOMRect na podlagi pravokotnikov, ki jih getClientRects() vrne za okvirne škatle po upoštevanju transformacij. Če je seznam prazen, so vse vrednosti nič. Če ima vsak pravokotnik na seznamu širino ali višino nič, metoda vrne prvi pravokotnik s seznama. Sicer vrne najmanjši pravokotnik, poravnan z osema, ki zajame pravokotnike z neničelno širino ali višino. Meritev vključuje notranji odmik in rob, ne pa zunanjega odmika. left in top sta koordinati glede na zgornji levi kot vidnega polja; width in height sta dimenziji. Vrednosti so v slikovnih pikah CSS in so lahko necele.

element.clientLeft in element.clientTop sta lastnosti samo za branje, ne metodi. Podajata celoštevilska odmika v slikovnih pikah CSS brez upoštevanja transformacij: debelino levega oziroma zgornjega roba in prostor, ki ga na isti strani morebiti zaseda drsni trak. Navpični drsni trak je lahko na levi, na primer pri postavitvi od desne proti levi. Notranji in zunanji odmiki se ne upoštevajo. Obe lastnosti vrneta nič za vrstično škatlo ali če škatle CSS ni.

DOMRect zajame stanje ob meritvi in se ne posodablja sam. Po pomiku ali spremembi postavitve ponovno izmeri, če potrebuješ sveže koordinate. Za koordinate glede na dokument prištej window.scrollX k left in window.scrollY k top. clientLeft in clientTop ne uporabljaj kot koordinat vidnega polja ali kot splošnega načina pretvorbe koordinat po transformaciji. To so programski vmesniki spletne platforme (CSSOM View), ne funkcije ECMAScripta 2024; razpoložljivost je odvisna od izvajalnega okolja.

Primeri

<!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

Odpri dokument HTML v brskalniku pri 100-odstotni povečavi strani in vrednosti `devicePixelRatio` `1`. Rezultat preberi v konzoli brskalnika. Skaliranje podvoji dimenzije pravokotnika, ne da bi premaknilo njegov zgornji levi kot; odmika ostaneta `3` in `5`.

Povezane lekcije

  • JavaScript · Lekcija 35 · Napredna · Različica: 4

Viri