Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

ResizeObserver.observe — obserwowanie rozmiaru elementu

ResizeObserver.observe rejestruje element do asynchronicznych powiadomień o rozmiarze. Opcja box wybiera obserwowany obszar.

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

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

observer.observe(target, options) przyjmuje Element i zwraca undefined. Powiadomienia trafiają do callbacku obserwatora podczas renderowania, nie synchronicznie.

box to domyślnie "content-box" (treść); "border-box" obejmuje też padding i obramowanie, a "device-pixel-content-box" mierzy treść w całkowitych pikselach urządzenia. Wybór określa wyzwalanie powiadomień, nie dostępne pola wpisu. Transformacje CSS nie wyzwalają obserwacji.

Ponowne wywołanie observe dla tego samego elementu z tą samą wartością box nie powoduje żadnej zmiany w Chromium. Nie zakładaj, że takie wywołanie zastąpi rejestrację lub zresetuje jej stan powiadomień w każdej przeglądarce. unobserve(target) usuwa jedną, disconnect() wszystkie. Unikaj cyklicznego zmieniania rozmiaru w callbacku. To Web API, nie funkcja ECMAScript; Node 24 nie potwierdza obsługi przeglądarkowej.

Przykłady

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

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