Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

onpopstate — obsługa zmiany aktywnego wpisu historii

Atrybut onpopstate elementu body ustawia procedurę obsługi zdarzenia popstate obiektu Window. Służy do reagowania na przechodzenie po historii sesji, na przykład przy użyciu Wstecz i Dalej, oraz odczytywania stanu docelowego wpisu.

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

Składnia

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

onpopstate jest atrybutem obsługi zdarzenia dostępnym na elemencie body, a nie atrybutem globalnym dowolnego elementu. Udostępnia procedurę obsługi popstate obiektu Window. Zapis window.onpopstate = handleState ustawia tę samą procedurę; nie tworzy drugiego, niezależnego nasłuchiwania.

popstate jest powiązane z przechodzeniem po historii sesji, na przykład za pomocą Wstecz, Dalej lub history.back(). Samo wywołanie history.pushState() albo history.replaceState() nie wywołuje tego zdarzenia. W procedurze obsługi event.state zawiera odtworzony stan docelowego wpisu; może mieć wartość null, więc przed odczytaniem jego pól trzeba to uwzględnić.

Kolejne przypisanie do window.onpopstate zastępuje poprzednią procedurę, a przypisanie null ją usuwa. Gdy potrzebujesz niezależnych procedur, użyj window.addEventListener('popstate', handleState). Nie traktuj popstate jako zdarzenia pozwalającego anulować nawigację.

Przykład celowo wysyła syntetyczne zdarzenie PopStateEvent z ustalonym stanem. Sprawdza powiązanie atrybutu z Window, ale nie zmienia historii ani nie testuje rzeczywistego przechodzenia po niej. W aplikacji polityka CSP może blokować atrybuty z kodem inline; w takim przypadku rejestruj procedurę w dozwolonym skrypcie.

Przykłady

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

Wynik

step=1

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

Źródła