Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

ResizeObserver — obserwowanie rozmiaru elementu

ResizeObserver powiadamia o rozmiarach elementów, także gdy okno nie zmienia wielkości. Pozwala dostosować komponent do dostępnego miejsca bez cyklicznego odpytywania DOM.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

const observer = new ResizeObserver((entries, observer) => { /* handle sizes */ });
observer.observe(element, { box: "content-box" });
observer.unobserve(element);
observer.disconnect();

ResizeObserver to API przeglądarki, nie funkcja ECMAScript; Node 24 nie potwierdza jego dostępności. Zdarzenie resize jest wywoływane na obiekcie Window, gdy zmienia się rozmiar okna, natomiast ResizeObserver powiadamia o zmianach rozmiaru obserwowanego elementu. Powiadomienia są asynchroniczne i grupowane podczas renderowania.

observe() domyślnie obserwuje content-box. border-box obejmuje padding i obramowanie, a device-pixel-content-box mierzy treść w całkowitych pikselach urządzenia. Opcja box wybiera wyzwalacz, nie filtr pól wyniku.

Callback otrzymuje entries i obserwator. Wpis zawiera target, contentRect oraz tablice rozmiarów, np. contentBoxSize; ich inlineSize i blockSize zależą od kierunku pisma. contentRect.width i contentRect.height opisują fizyczne wymiary treści.

Unikaj zmian rozmiaru tworzących pętlę w callbacku: przeglądarka może zgłosić błąd pętli obserwacji. Same transformacje CSS nie wyzwalają powiadomień. unobserve(element) kończy jedną obserwację, a disconnect() wszystkie. Sprawdź dostępność API i potrzebnych opcji w docelowych przeglądarkach.

Przykłady

(() => {
  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" });
})();

Wynik

120 x 40

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła