Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

ResizeObserverEntry: promatrani element i pravokutnik sadržaja

Pomoću `target` utvrdi na koji se element zapis odnosi, a iz `contentRect` pročitaj prijavljene dimenzije, koje za HTML element ne uključuju unutarnji razmak ni obrub.

Verzija: Current web platform; runtime support varies

Sintaksa

entry.target
entry.contentRect
entry.contentRect.width
entry.contentRect.height

Tijekom iscrtavanja preglednik povratnoj funkciji ResizeObserver predaje niz zapisa ResizeObserverEntry. Svojstvo entry.target namijenjeno je samo čitanju i upućuje na sam promatrani element, a ne na njegovu kopiju. Ako promatraš više elemenata, usporedi target s poznatom referencom na element pomoću operatora ===.

entry.contentRect je objekt DOMRectReadOnly s mjerenjem iz trenutka obavijesti koje se ne ažurira u stvarnom vremenu. Za HTML element width i height označavaju fizičku širinu i visinu okvira sadržaja u CSS pikselima, bez unutarnjeg razmaka i obruba. Za grafički SVG element bez CSS okvira rasporeda mjerenje opisuje njegov granični pravokutnik. Nemoj ga zamijeniti s rezultatom getBoundingClientRect(), koji za HTML vraća pravokutnik što obuhvaća okvire s obrubom u odnosu na vidljivo područje preglednika.

contentRect je zadržan radi kompatibilnosti sa starijim implementacijama. Za logičke dimenzije upotrijebi contentBoxSize ako je podržan: inlineSize i blockSize slijede način pisanja. Opcija box metode observe() određuje promjene kojeg okvira pokreću obavijesti; odabir border-box ne znači da će contentRect mjeriti okvir s obrubom. ECMAScript 2024 ovdje označava samo polaznu verziju jezika JavaScript. Oba svojstva definira specifikacija Resize Observer, a ne ECMAScript; njihova dostupnost ovisi o izvršnom okruženju.

Primjeri

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>ResizeObserverEntry example</title>
</head>
<body>
<script>
(() => {
  const box = document.createElement('div');
  Object.assign(box.style, {
    boxSizing: 'content-box',
    width: '120px',
    height: '60px',
    padding: '10px',
    border: '2px solid black'
  });
  document.body.append(box);

  const observer = new ResizeObserver(([entry]) => {
    const { width, height } = entry.contentRect;
    console.log(`${entry.target === box}: ${width} × ${height} CSS px`);
    observer.disconnect();
    box.remove();
  });
  observer.observe(box);
})();
</script>
</body>
</html>

Rezultat

true: 120 × 60 CSS px

Spremi primjer kao `.html` datoteku i otvori je u pregledniku koji podržava `ResizeObserver`. Otvori razvojnu konzolu i ponovno učitaj stranicu. Prva obavijest ispisuje `true: 120 × 60 CSS px`: `true` potvrđuje da je to isti element, a dimenzije ne uključuju unutarnji razmak ni obrub. Kôd zatim prekida promatranje i uklanja element.

Povezane lekcije

  • JavaScript · Lekcija 32 · Srednje · Verzija: 3

Izvori