CKTIS / JavaScript
ResizeObserver – sledovanie veľkosti prvku
ResizeObserver oznamuje veľkosti prvkov, aj keď sa veľkosť okna nemení. Komponent tak môže reagovať na dostupný priestor bez opakovaného dopytovania DOM.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
const observer = new ResizeObserver((entries, observer) => { /* handle sizes */ });
observer.observe(element, { box: "content-box" });
observer.unobserve(element);
observer.disconnect();ResizeObserver je rozhranie prehliadača, nie funkcia ECMAScriptu; Node 24 nepotvrdzuje jeho dostupnosť. Udalosť resize sa vyvolá na objekte Window, keď sa zmení veľkosť okna, zatiaľ čo ResizeObserver oznamuje zmeny veľkosti sledovaného prvku. Oznámenia sú asynchrónne a počas vykresľovania sa zoskupujú.
observe() predvolene sleduje content-box. border-box zahŕňa padding a okraje, zatiaľ čo device-pixel-content-box meria obsah v celých pixeloch zariadenia. Voľba box určuje spúšťač, nie filter polí výsledku.
Callback dostáva entries a observer. Záznam obsahuje target, contentRect a polia veľkostí, napríklad contentBoxSize; ich inlineSize a blockSize závisia od smeru písma. contentRect.width a contentRect.height opisujú fyzické rozmery obsahu.
Vyhnite sa zmenám veľkosti v callbacku, ktoré vytvárajú spätnoväzbové slučky: prehliadač môže nahlásiť chybu slučky sledovania zmeny veľkosti. Samotné transformácie CSS oznámenia nevyvolávajú. unobserve(element) ukončí jedno sledovanie a disconnect() všetky. Overte dostupnosť rozhrania a potrebných volieb v cieľových prehliadačoch.
Príklady
(() => {
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" });
})();Výsledok
120 x 40
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.