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.heightTijekom 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