WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

ResizeObserver – Elementgröße beobachten

ResizeObserver meldet Elementgrößen auch dann, wenn sich die Fenstergröße nicht ändert. So kann eine Komponente auf den verfügbaren Platz reagieren, ohne das DOM wiederholt abzufragen.

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

Syntax

const observer = new ResizeObserver((entries, observer) => { /* handle sizes */ });
observer.observe(element, { box: "content-box" });
observer.unobserve(element);
observer.disconnect();

ResizeObserver ist eine Browser-API und keine ECMAScript-Funktion; Node 24 belegt nicht, dass sie verfügbar ist. Das Ereignis resize wird auf Window ausgelöst, wenn sich die Fenstergröße ändert. ResizeObserver hingegen meldet Größenänderungen eines beobachteten Elements. Benachrichtigungen erfolgen asynchron und werden während des Renderns gebündelt.

observe() überwacht standardmäßig die content-box. border-box schließt Padding und Rahmen ein, während device-pixel-content-box den Inhalt in ganzzahligen Geräte-Pixeln misst. Die Option box legt den Auslöser fest und filtert nicht die Ergebnisfelder.

Der Callback erhält entries und den Observer. Ein Eintrag enthält target, contentRect und Größen-Arrays wie contentBoxSize; deren inlineSize und blockSize hängen von der Schreibrichtung ab. contentRect.width und contentRect.height geben die physischen Abmessungen des Inhalts an.

Vermeide Größenänderungen im Callback, die Rückkopplungsschleifen erzeugen: Der Browser kann einen Fehler wegen einer Resize-Observation-Schleife melden. CSS-Transformationen allein lösen keine Benachrichtigungen aus. unobserve(element) beendet eine einzelne Beobachtung, disconnect() alle. Prüfe die Verfügbarkeit der API und der benötigten Optionen in den Zielbrowsern.

Beispiele

(() => {
  if (typeof ResizeObserver !== "function") {
    throw new Error("ResizeObserver unavailable");
  }

  const box = document.createElement("div");
  box.style.cssText = "all: initial; display: block; position: fixed; width: 120px; height: 40px; padding: 0; border: 0; box-sizing: content-box; writing-mode: horizontal-tb;";
  document.body.append(box);

  const observer = new ResizeObserver(([entry]) => {
    console.log(`${entry.contentRect.width} x ${entry.contentRect.height}`);
    observer.disconnect();
    box.remove();
  });
  observer.observe(box, { box: "content-box" });
})();

Ergebnis

120 x 40

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen