CKTIS / JavaScript
ResizeObserverEntry: наблюдаван елемент и правоъгълник на съдържанието
Използвай `target`, за да определиш за кой елемент е записът, и `contentRect`, за да прочетеш отчетените размери, които при HTML елемент не включват вътрешния отстъп и рамката.
Версия: Current web platform; runtime support varies
Синтаксис
entry.target
entry.contentRect
entry.contentRect.width
entry.contentRect.heightПри визуализиране браузърът подава масив от записи ResizeObserverEntry на функцията за обратно извикване на ResizeObserver. Свойството entry.target е само за четене и сочи към самия наблюдаван елемент, а не към негово копие. Ако наблюдаваш няколко елемента, сравни target с известна референция към елемент чрез ===.
entry.contentRect е обект DOMRectReadOnly, който съдържа измерването от момента на известяването и не се обновява текущо. За HTML елемент width и height са физическите ширина и височина на областта на съдържанието в CSS пиксели, без вътрешния отстъп и рамката. За графичен SVG елемент без CSS кутия за оформление измерването описва неговия ограждащ правоъгълник. Не го бъркай с резултата от getBoundingClientRect(), който за HTML връща правоъгълник около кутиите с рамките спрямо видимата област на браузъра.
contentRect се запазва за обратна съвместимост. За логически размери използвай contentBoxSize, ако се поддържа: inlineSize и blockSize следват режима на писане. Опцията box на observe() определя промените в коя кутия задействат известията; изборът на border-box не кара contentRect да измерва кутията с рамката. ECMAScript 2024 тук обозначава само базовата версия на езика JavaScript. И двете свойства са определени в спецификацията Resize Observer, а не в ECMAScript; наличността им зависи от средата за изпълнение.
Примери
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>ResizeObserverEntry example</title>
</head>
<body>
<script>
(() => {
const box = document.createElement('div');
Object.assign(box.style, {
boxSizing: 'content-box',
width: '120px',
height: '60px',
padding: '10px',
border: '2px solid black'
});
document.body.append(box);
const observer = new ResizeObserver(([entry]) => {
const { width, height } = entry.contentRect;
console.log(`${entry.target === box}: ${width} × ${height} CSS px`);
observer.disconnect();
box.remove();
});
observer.observe(box);
})();
</script>
</body>
</html>Резултат
true: 120 × 60 CSS px
Запази примера като `.html` файл и го отвори в браузър с поддръжка на `ResizeObserver`. Отвори конзолата за разработчици и презареди страницата. Първото известие извежда `true: 120 × 60 CSS px`: `true` потвърждава, че елементът е същият, а размерите не включват вътрешния отстъп и рамката. След това кодът спира наблюдението и премахва елемента.
Свързани уроци
- JavaScript · Урок 32 · Средно · Версия: 3