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

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.

Zdroje