Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

ResizeObserver.observe — sledovanie veľkosti prvku

ResizeObserver.observe zaregistruje prvok na asynchrónne upozornenia o jeho veľkosti. Voľba box určuje sledovanú oblasť.

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

observer.observe(target, { box: "content-box" });

observer.observe(target, options) prijíma Element a vracia undefined. Upozornenia sa dostávajú do callbacku observera počas vykresľovania, nie synchrónne.

Predvolená hodnota box je "content-box" (obsah); "border-box" zahŕňa aj padding a okraje, zatiaľ čo "device-pixel-content-box" meria obsah v celých pixeloch zariadenia. Táto voľba určuje, kedy sa upozornenia spúšťajú, nie dostupné polia záznamu. Transformácie CSS pozorovania nespúšťajú.

Opakované volanie observe pre ten istý prvok s rovnakou hodnotou box nemá v prehliadači Chromium žiadny účinok. Nespoliehajte sa na to, že takéto volanie vo všetkých prehliadačoch nahradí registráciu alebo vráti jej stav upozornení na počiatočnú hodnotu. unobserve(target) jednu registráciu odstráni, disconnect() odstráni všetky. V callbacku sa vyhnite cyklickým zmenám veľkosti. Ide o Web API, nie funkciu ECMAScriptu; Node 24 nepotvrdzuje podporu v prehliadačoch.

Prí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ý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.

Zdroje