CKTIS / JavaScript
ResizeObserver — praćenje veličine elementa
ResizeObserver dojavljuje veličine elemenata čak i kada se veličina prozora ne mijenja. Omogućuje komponenti da reagira na dostupan prostor bez ponovljenog ispitivanja DOM-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
const observer = new ResizeObserver((entries, observer) => { /* handle sizes */ });
observer.observe(element, { box: "content-box" });
observer.unobserve(element);
observer.disconnect();ResizeObserver je API preglednika, a ne značajka ECMAScripta; Node 24 ne potvrđuje njegovu dostupnost. Događaj resize pokreće se na objektu Window kada se promijeni veličina prozora, dok ResizeObserver dojavljuje promjene veličine praćenog elementa. Obavijesti su asinkrone i grupiraju se tijekom iscrtavanja.
observe() prema zadanim postavkama prati content-box. border-box obuhvaća unutarnji razmak i obrube, a device-pixel-content-box mjeri sadržaj u cijelim pikselima uređaja. Opcija box odabire okidač, a ne filtrira polja rezultata.
Povratna funkcija prima entries i promatrač. Zapis sadrži target, contentRect i nizove veličina kao što je contentBoxSize; njihovi inlineSize i blockSize ovise o smjeru pisanja. contentRect.width i contentRect.height opisuju fizičke dimenzije sadržaja.
Izbjegavajte promjene veličine u povratnoj funkciji koje stvaraju povratne petlje: preglednik može prijaviti pogrešku petlje promatranja promjene veličine. Same CSS transformacije ne pokreću obavijesti. unobserve(element) zaustavlja jedno praćenje, a disconnect() sva. Provjerite dostupnost API-ja i potrebnih opcija u ciljanim preglednicima.
Primjeri
(() => {
if (typeof ResizeObserver !== "function") {
throw new Error("ResizeObserver unavailable");
}
const box = document.createElement("div");
box.style.cssText = "all: initial; display: block; position: fixed; width: 120px; height: 40px; padding: 0; border: 0; box-sizing: content-box; writing-mode: horizontal-tb;";
document.body.append(box);
const observer = new ResizeObserver(([entry]) => {
console.log(`${entry.contentRect.width} x ${entry.contentRect.height}`);
observer.disconnect();
box.remove();
});
observer.observe(box, { box: "content-box" });
})();Rezultat
120 x 40
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.