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.