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

CKTIS / JavaScript

ResizeObserverEntry — наблюдаваният елемент и размерът му

ResizeObserverEntry описва един елемент в известие от ResizeObserver. Свойството target указва елемента, а contentRect предоставя размерите му. Научете разликата между областта на съдържанието на HTML елемент и ограничителния правоъгълник на SVG.

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

Синтаксис

new ResizeObserver((entries) => {
  for (const entry of entries) {
    const element = entry.target;
    const { width, height } = entry.contentRect;
  }
}).observe(element);

ResizeObserverEntry е запис, предоставен в масива entries на callback функцията на ResizeObserver. Едно извикване може да достави записи за няколко наблюдавани елемента, затова обработвайте масива, вместо да приемате, че съдържа само един резултат.

ResizeObserverEntry.target е свойство само за четене, което препраща към наблюдавания Element или SVGElement. То свързва измерването с правилния елемент. Самата препратка е само за четене, но посоченият елемент все още може да бъде променян.

ResizeObserverEntry.contentRect е свойство само за четене, което връща DOMRectReadOnly. За HTML елемент то описва областта на съдържанието без вътрешни отстъпи и рамки. За графичен SVG елемент без свързана кутия в CSS оформлението то описва ограничителния правоъгълник на елемента. За външен елемент <svg> с кутия в CSS оформлението свойството може вместо това да описва неговата област на съдържанието според CSS. width и height са размери, а не външният размер на HTML елемента. Това по-старо свойство е запазено за съвместимост; по-новите свойства като contentBoxSize и borderBoxSize имат отделни изисквания за поддръжка.

Това е интерфейс на Web API, а не функция на конкретно издание на ECMAScript. MDN посочва, че основната поддръжка е широко достъпна от юли 2020 г.; наличността на допълнителни свойства може да се различава. Node 24 не доказва поддръжка в браузърите. Известията са асинхронни. Избягвайте промени в размера в callback функцията, които безкрайно предизвикват нови известия.

Примери

(() => {
  if (typeof ResizeObserver === "undefined") {
    throw new Error("ResizeObserver is not supported");
  }

  const box = document.createElement("div");
  box.id = "resize-demo";
  box.style.cssText = "display: block; box-sizing: content-box; width: 120px; height: 60px; padding: 10px; border: 2px solid black;";
  document.body.append(box);

  const observer = new ResizeObserver((entries) => {
    for (const entry of entries) {
      const { width, height } = entry.contentRect;
      console.log(`${entry.target.id}: ${width} x ${height}`);
    }
    observer.disconnect();
    box.remove();
  });

  observer.observe(box);
})();

Резултат

resize-demo: 120 x 60

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

Източници