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.