CKTIS / JavaScript
ResizeObserver.observe — наблюдение на размера на елемент
ResizeObserver.observe регистрира елемент за асинхронни известия за размера му. Опцията box избира наблюдаваната област.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
observer.observe(target, { box: "content-box" });observer.observe(target, options) приема Element и връща undefined. Известията достигат до callback функцията на наблюдателя по време на визуализирането, а не синхронно.
По подразбиране box е "content-box" (съдържание); "border-box" включва и padding и рамките, а "device-pixel-content-box" измерва съдържанието в цели пиксели на устройството. Този избор определя кога се задействат известията, а не кои полета са налични в записа. CSS трансформациите не задействат наблюдения.
Повторното извикване на observe за същия елемент със същата стойност на box няма ефект в Chromium. Не разчитайте, че такова извикване ще замени регистрацията или ще върне състоянието ѝ за известяване в начално положение във всички браузъри. unobserve(target) премахва една регистрация, а disconnect() премахва всички. Избягвайте циклични промени на размера в callback функцията. Това е Web API, а не функция на ECMAScript; Node 24 не потвърждава поддръжка от браузърите.
Примери
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" });Резултат
120 x 40
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.