Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

ResizeObserverEntry — obserwowany element i jego rozmiar

ResizeObserverEntry opisuje pojedynczy element w powiadomieniu ResizeObserver. Właściwość target wskazuje element, a contentRect udostępnia jego wymiary. Poznaj różnicę między obszarem treści HTML a prostokątem ograniczającym SVG.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

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

ResizeObserverEntry to rekord przekazywany w tablicy entries do funkcji zwrotnej ResizeObserver. Jedno wywołanie może dostarczyć rekordy dla kilku obserwowanych elementów, dlatego należy przetwarzać tablicę, a nie zakładać, że zawiera tylko jeden wynik.

ResizeObserverEntry.target jest właściwością tylko do odczytu: wskazuje obserwowany Element lub SVGElement. Pozwala powiązać pomiar z właściwym elementem. Samo odwołanie jest tylko do odczytu, ale wskazany element nadal można modyfikować.

ResizeObserverEntry.contentRect jest właściwością tylko do odczytu zwracającą DOMRectReadOnly. Dla elementu HTML opisuje obszar treści, bez paddingu i obramowania. Dla elementu graficznego SVG, który nie ma powiązanej ramki układu CSS, opisuje jego prostokąt ograniczający. Jeśli zewnętrzny element <svg> ma ramkę układu CSS, właściwość może zamiast tego opisywać jego obszar treści CSS. width i height to wymiary, a nie rozmiar zewnętrzny elementu HTML. Jest to starsza właściwość zachowana dla zgodności; nowsze właściwości, takie jak contentBoxSize i borderBoxSize, mają osobne wymagania dotyczące obsługi.

To interfejs Web API, nie funkcja określonej edycji ECMAScript. MDN oznacza podstawową obsługę jako szeroko dostępną od lipca 2020; dostępność dodatkowych właściwości może się różnić. Node 24 nie dowodzi obsługi w przeglądarce. Powiadomienia są asynchroniczne. Unikaj zmian rozmiaru w funkcji zwrotnej, które bez końca wywołują kolejne powiadomienia.

Przykłady

(() => {
  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);
})();

Wynik

resize-demo: 120 x 60

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła