Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

ResizeObserverEntry: obserwowany element i prostokąt zawartości

Użyj `target`, aby ustalić, którego elementu dotyczy wpis, a `contentRect`, aby odczytać zgłoszone wymiary bez doliczania dopełnienia i obramowania w przypadku elementu HTML.

Wersja: Current web platform; runtime support varies

Składnia

entry.target
entry.contentRect
entry.contentRect.width
entry.contentRect.height

Podczas renderowania przeglądarka przekazuje do funkcji zwrotnej ResizeObserver tablicę wpisów ResizeObserverEntry. Właściwość entry.target jest tylko do odczytu i wskazuje rzeczywisty obserwowany element, a nie jego kopię. Jeśli obserwujesz kilka elementów, porównaj target ze znaną referencją za pomocą ===.

entry.contentRect to obiekt DOMRectReadOnly zawierający pomiar z chwili powiadomienia, a nie dane aktualizowane na bieżąco. Dla elementu HTML width i height to fizyczna szerokość i wysokość pola zawartości w pikselach CSS, bez dopełnienia i obramowania. Dla elementu graficznego SVG bez pola układu CSS pomiar dotyczy jego prostokąta ograniczającego. Nie myl tego prostokąta z wynikiem getBoundingClientRect(), który dla HTML opisuje obszar obejmujący pola obramowania względem obszaru widoku.

contentRect zachowano dla zgodności wstecznej. Jeśli potrzebujesz wymiarów logicznych, użyj contentBoxSize, o ile środowisko je obsługuje: wartości inlineSize i blockSize zależą od trybu pisma. Opcja box metody observe() określa, którego pola zmiany wywołują powiadomienia; ustawienie border-box nie sprawia, że contentRect zaczyna podawać wymiary pola obramowania. ECMAScript 2024 wskazuje wyłącznie bazową wersję języka JavaScript. Obie właściwości definiuje specyfikacja Resize Observer, a nie ECMAScript; ich dostępność zależy od środowiska.

Przykłady

<!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>

Wynik

true: 120 × 60 CSS px

Zapisz przykład jako plik `.html` i otwórz go w przeglądarce obsługującej `ResizeObserver`. Otwórz konsolę i odśwież stronę. Pierwsze powiadomienie wypisze `true: 120 × 60 CSS px`: `true` potwierdza tożsamość elementu, a wymiary nie obejmują dopełnienia ani obramowania. Następnie kod kończy obserwację i usuwa element.

Powiązane lekcje

  • JavaScript · Lekcja 32 · Średniozaawansowany · Wersja: 3

Źródła