CKTIS / JavaScript
ResizeObserver – sledování velikosti prvku
ResizeObserver hlásí velikosti prvků, i když se velikost okna nemění. Komponenta tak může reagovat na dostupný prostor, aniž by opakovaně dotazovala DOM.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
const observer = new ResizeObserver((entries, observer) => { /* handle sizes */ });
observer.observe(element, { box: "content-box" });
observer.unobserve(element);
observer.disconnect();ResizeObserver je rozhraní prohlížeče, nikoli funkce ECMAScriptu; Node 24 nepotvrzuje jeho dostupnost. Událost resize se vyvolá na objektu Window, když se změní velikost okna, zatímco ResizeObserver hlásí změny velikosti sledovaného prvku. Oznámení jsou asynchronní a během vykreslování se slučují.
observe() ve výchozím nastavení sleduje content-box. border-box zahrnuje padding a okraje, zatímco device-pixel-content-box měří obsah v celých pixelech zařízení. Volba box určuje spouštěč, nikoli filtr polí výsledku.
Callback dostává entries a observer. Záznam obsahuje target, contentRect a pole velikostí, například contentBoxSize; jejich inlineSize a blockSize závisejí na směru psaní. contentRect.width a contentRect.height popisují fyzické rozměry obsahu.
Vyhněte se změnám velikosti v callbacku, které vytvářejí zpětnovazební smyčky: prohlížeč může nahlásit chybu smyčky sledování změn velikosti. Samotné transformace CSS oznámení nevyvolávají. unobserve(element) ukončí jedno sledování, disconnect() všechna. Ověřte dostupnost rozhraní a potřebných voleb v cílových prohlížečích.
Pří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ýsledek
120 x 40
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.