WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Das Ereignis `resize` von `Window`

Reagiere mit `resize` auf `window` auf Größenänderungen des Layout-Viewports. Mit `ResizeObserver` beobachtest du dagegen die Größe eines einzelnen Elements.

Version: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

window.addEventListener("resize", handler);
window.removeEventListener("resize", handler);

// Alternative: assign a single handler property.
window.onresize = handler;
window.onresize = null;

Der Browser löst resize auf window aus, wenn sich die Größe des Layout-Viewports ändert. Das ist eine Webplattform-API und kein Teil von ECMAScript. Der Browser liefert ein einfaches Event ohne Angaben zu den neuen Abmessungen. Das Ereignis hat keine Bubbling-Phase und lässt sich nicht mit preventDefault() abbrechen.

Lies die aktuelle Breite und Höhe aus window.innerWidth und window.innerHeight. Die Werte sind in CSS-Pixeln angegeben und schließen gegebenenfalls die Breite der vertikalen bzw. die Höhe der horizontalen Bildlaufleiste ein. Braucht deine Anwendung die Abmessungen sofort, rufe die Aktualisierungsfunktion bei der Initialisierung auf: Die Registrierung allein ruft sie nicht auf. Beim Ändern der Größe kann das Ereignis wiederholt auftreten. Vermeide daher aufwendige Arbeit bei jedem Aufruf.

Mit addEventListener("resize", handler) kannst du mehrere verschiedene Listener registrieren. Entferne einen nicht mehr benötigten Listener mit removeEventListener() und demselben Ereignistyp, derselben Funktionsreferenz und demselben capture-Wert. Eine Zuweisung an window.onresize ersetzt nur den über diese Eigenschaft gesetzten Handler, nicht die mit addEventListener() registrierten Listener. Mit null entfernst du den Handler der Eigenschaft.

Beobachte Größenänderungen einzelner Elemente mit ResizeObserver: Ein Element kann seine Größe ändern, ohne dass sich die Größe des Layout-Viewports ändert. Für die Größe des sichtbaren Teils der Seite gibt es das separate Ereignis resize auf window.visualViewport, sofern diese API verfügbar ist.

Beispiele

{
  const target = typeof window === "undefined" ? new EventTarget() : window;

  function reportResize(event) {
    console.log(`${event.type}: bubbles=${event.bubbles}, cancelable=${event.cancelable}`);
  }

  target.addEventListener("resize", reportResize);
  target.dispatchEvent(new Event("resize"));
  target.removeEventListener("resize", reportResize);
  target.dispatchEvent(new Event("resize"));
}

Ergebnis

resize: bubbles=false, cancelable=false

Führe den Code in einer Browserkonsole oder mit Node.js 24 aus. Im Browser verwendet der Code `window`, in Node.js ein eigenständiges `EventTarget`-Objekt. Das erste synthetische Ereignis ruft den Listener synchron auf und gibt eine Zeile aus. Das zweite wird nach dem Entfernen des Listeners ausgelöst und erzeugt daher keine weitere Ausgabe. Keines davon ändert die Größe des Viewports.

Zugehörige Lektionen

  • JavaScript · Lektion 27 · Mittlere Stufe · Version: 3

Quellen