База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници