CKTIS / JavaScript
ResizeObserverEntry — promatrani element i njegova veličina
ResizeObserverEntry opisuje jedan element u obavijesti ResizeObserver. Njegovo svojstvo target određuje element, dok contentRect pruža njegove dimenzije. Saznajte razliku između okvira sadržaja HTML elementa i graničnog okvira SVG-a.
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
new ResizeObserver((entries) => {
for (const entry of entries) {
const element = entry.target;
const { width, height } = entry.contentRect;
}
}).observe(element);ResizeObserverEntry je zapis koji se funkciji povratnog poziva ResizeObserver predaje u polju entries. Jedan poziv može dostaviti zapise za više promatranih elemenata, stoga obradite polje umjesto da pretpostavite kako sadrži samo jedan rezultat.
ResizeObserverEntry.target je svojstvo samo za čitanje koje upućuje na promatrani Element ili SVGElement. Omogućuje povezivanje mjerenja s odgovarajućim elementom. Sama je referenca samo za čitanje, ali element na koji upućuje i dalje se može mijenjati.
ResizeObserverEntry.contentRect je svojstvo samo za čitanje koje vraća DOMRectReadOnly. Za HTML element opisuje okvir sadržaja bez unutarnjih margina i obruba. Za grafički element SVG-a koji nema pridruženi okvir CSS rasporeda opisuje njegov granični okvir. Za vanjski element <svg> s okvirom CSS rasporeda može umjesto toga opisivati njegov CSS okvir sadržaja. width i height dimenzije su, a ne vanjska veličina HTML elementa. Ovo starije svojstvo zadržano je radi kompatibilnosti; novija svojstva kao što su contentBoxSize i borderBoxSize imaju zasebne zahtjeve za podršku.
Ovo je sučelje Web API-ja, a ne značajka određenog izdanja ECMAScripta. MDN navodi da je osnovna podrška široko dostupna od srpnja 2020.; dostupnost dodatnih svojstava može se razlikovati. Node 24 ne dokazuje podršku u preglednicima. Obavijesti su asinkrone. Izbjegavajte promjene veličine u funkciji povratnog poziva koje beskonačno pokreću nove obavijesti.
Primjeri
(() => {
if (typeof ResizeObserver === "undefined") {
throw new Error("ResizeObserver is not supported");
}
const box = document.createElement("div");
box.id = "resize-demo";
box.style.cssText = "display: block; box-sizing: content-box; width: 120px; height: 60px; padding: 10px; border: 2px solid black;";
document.body.append(box);
const observer = new ResizeObserver((entries) => {
for (const entry of entries) {
const { width, height } = entry.contentRect;
console.log(`${entry.target.id}: ${width} x ${height}`);
}
observer.disconnect();
box.remove();
});
observer.observe(box);
})();Rezultat
resize-demo: 120 x 60
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.