CKTIS / HTML
onpopstate — obrada promjena aktivnog unosa u povijesti
Atribut onpopstate elementa body postavlja rukovatelj događajem popstate objekta Window. Stranica tako može reagirati na kretanje kroz povijest sesije, primjerice pomoću gumba Natrag i Naprijed, te pročitati stanje odredišnog unosa.
Verzija: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<body onpopstate="handleState(event)">
window.onpopstate = handleState;onpopstate je atribut rukovatelja događajima dostupan na elementu body, a ne globalni atribut za proizvoljne elemente. Omogućuje rukovatelja popstate objekta Window. Dodjela window.onpopstate = handleState postavlja istog rukovatelja; ne stvara drugog, neovisnog slušatelja.
Događaj popstate povezan je s kretanjem kroz povijest sesije, primjerice pomoću gumba Natrag i Naprijed ili pozivom history.back(). Sam poziv history.pushState() ili history.replaceState() ne pokreće taj događaj. U rukovatelju event.state sadrži vraćeno stanje odredišnog unosa. Može biti null, pa to uzmi u obzir prije pristupa njegovim svojstvima.
Kasnija dodjela vrijednosti za window.onpopstate zamjenjuje prethodnog rukovatelja, a dodjela vrijednosti null uklanja ga. Za neovisne rukovatelje upotrijebi window.addEventListener('popstate', handleState). Nemoj smatrati popstate načinom za otkazivanje navigacije.
Primjer namjerno šalje sintetički događaj PopStateEvent s fiksnim stanjem. Provjerava povezanost atributa s objektom Window, ali ne mijenja povijest niti testira stvarno kretanje kroz nju. CSP aplikacije može blokirati atribute rukovatelja u retku; u tom slučaju registriraj rukovatelja u dopuštenoj skripti.
Primjeri
<!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>Rezultat
step=1
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.