WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

onpopstate — Änderungen des aktiven Verlaufseintrags behandeln

Das onpopstate-Attribut von body legt den popstate-Ereignishandler des Window-Objekts fest. Damit kann eine Seite auf das Durchlaufen des Sitzungsverlaufs, etwa über Zurück und Vorwärts, reagieren und den Zustand des Zieleintrags lesen.

Version: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

<body onpopstate="handleState(event)">
window.onpopstate = handleState;

onpopstate ist ein Ereignishandler-Attribut für body, kein globales Attribut für beliebige Elemente. Es stellt den popstate-Handler des Window-Objekts bereit. Mit window.onpopstate = handleState wird derselbe Handler festgelegt; dadurch entsteht kein zweiter, unabhängiger Listener.

popstate tritt im Zusammenhang mit dem Durchlaufen des Sitzungsverlaufs auf, zum Beispiel über Zurück, Vorwärts oder history.back(). Allein der Aufruf von history.pushState() oder history.replaceState() löst das Ereignis nicht aus. Im Handler enthält event.state den wiederhergestellten Zustand des Zieleintrags. Der Wert kann null sein; berücksichtige das, bevor du auf seine Eigenschaften zugreifst.

Eine spätere Zuweisung an window.onpopstate ersetzt den vorherigen Handler; mit der Zuweisung von null wird er entfernt. Für unabhängige Handler verwendest du window.addEventListener('popstate', handleState). Behandle popstate nicht als Möglichkeit, die Navigation abzubrechen.

Das Beispiel löst absichtlich ein synthetisches PopStateEvent mit einem festgelegten Zustand aus. Es prüft die Verbindung des Attributs zu Window, ändert aber weder den Verlauf noch testet es das tatsächliche Durchlaufen des Verlaufs. Die CSP einer Anwendung kann Inline-Handler-Attribute blockieren. Registriere den Handler in diesem Fall in einem zulässigen Skript.

Beispiele

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>onpopstate demo</title>
</head>
<body onpopstate="document.getElementById('result').textContent = 'step=' + event.state.step">
  <button id="test" type="button">Test</button>
  <output id="result">Ready</output>
  <script>
    document.getElementById('test').addEventListener('click', () => {
      window.dispatchEvent(new PopStateEvent('popstate', {
        state: { step: 1 }
      }));
    });
  </script>
</body>
</html>

Ergebnis

step=1

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