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.