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

CKTIS / JavaScript

ResizeObserver — наблюдение на размера на елемент

ResizeObserver съобщава размерите на елементите дори когато размерът на прозореца не се променя. Така компонентът може да реагира на наличното пространство, без многократно да проверява DOM.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

const observer = new ResizeObserver((entries, observer) => { /* handle sizes */ });
observer.observe(element, { box: "content-box" });
observer.unobserve(element);
observer.disconnect();

ResizeObserver е API на браузъра, а не функция на ECMAScript; Node 24 не потвърждава наличността му. Събитието resize се задейства върху обекта Window при промяна на размера на прозореца, докато ResizeObserver уведомява за промени в размера на наблюдаван елемент. Известията са асинхронни и се групират по време на визуализирането.

По подразбиране observe() наблюдава content-box. border-box включва вътрешните отстояния и рамките, а device-pixel-content-box измерва съдържанието в цели пиксели на устройството. Опцията box избира условието за задействане, а не филтрира полетата в резултата.

Callback получава entries и наблюдателя. Един запис съдържа target, contentRect и масиви с размери, например contentBoxSize; техните inlineSize и blockSize зависят от режима на писане. contentRect.width и contentRect.height описват физическите размери на съдържанието.

Избягвайте промени в размера в callback, които създават цикли на обратна връзка: браузърът може да съобщи за грешка в цикъл на наблюдение на промяна на размера. Само CSS трансформациите не задействат известия. unobserve(element) прекратява едно наблюдение, а disconnect() — всички. Проверете наличността на API и необходимите опции в целевите браузъри.

Примери

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

Резултат

120 x 40

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

Източници