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

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

Източници