Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje