CKTIS / JavaScript
ResizeObserver.observe — sledování velikosti prvku
ResizeObserver.observe zaregistruje prvek pro asynchronní oznámení o jeho velikosti. Volba box určuje sledovanou oblast.
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
observer.observe(target, { box: "content-box" });observer.observe(target, options) přijímá Element a vrací undefined. Oznámení se dostávají do callbacku observeru během vykreslování, nikoli synchronně.
Výchozí hodnota box je "content-box" (obsah); "border-box" zahrnuje také padding a okraje, zatímco "device-pixel-content-box" měří obsah v celých pixelech zařízení. Tato volba určuje, kdy se oznámení spouštějí, nikoli dostupná pole záznamu. Transformace CSS sledování nespouštějí.
Opakované volání observe pro stejný prvek se stejnou hodnotou box nemá v Chromiu žádný účinek. Nespoléhejte na to, že takové volání ve všech prohlížečích nahradí registraci nebo obnoví její stav oznámení do výchozího stavu. unobserve(target) jednu registraci odstraní, disconnect() odstraní všechny. V callbacku se vyhněte cyklickým změnám velikosti. Jde o Web API, nikoli funkci ECMAScriptu; Node 24 nepotvrzuje podporu v prohlížečích.
Příklady
const target = document.createElement("div");
target.style.cssText = "all: initial; display: block; width: 120px; height: 40px;";
document.body.append(target);
const observer = new ResizeObserver(([entry]) => {
console.log(`${entry.contentRect.width} x ${entry.contentRect.height}`);
observer.disconnect();
target.remove();
});
observer.observe(target, { 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.