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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.