CKTIS / HTML
onpopstate — zpracování změn aktivní položky historie
Atribut onpopstate prvku body nastavuje obsluhu události popstate objektu Window. Stránka tak může reagovat na procházení historie relace, například pomocí tlačítek Zpět a Vpřed, a číst stav cílové položky.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<body onpopstate="handleState(event)">
window.onpopstate = handleState;onpopstate je atribut obsluhy události dostupný na prvku body, nikoli globální atribut pro libovolné prvky. Zpřístupňuje obsluhu popstate objektu Window. Přiřazení window.onpopstate = handleState nastaví tutéž obsluhu; nevytvoří druhý, nezávislý listener.
Událost popstate souvisí s procházením historie relace, například pomocí tlačítek Zpět a Vpřed nebo voláním history.back(). Samotné volání history.pushState() nebo history.replaceState() tuto událost nevyvolá. V obsluze obsahuje event.state obnovený stav cílové položky. Může mít hodnotu null, proto s tím počítej před přístupem k jeho vlastnostem.
Pozdější přiřazení k window.onpopstate nahradí předchozí obsluhu a přiřazení null ji odstraní. Pro nezávislé obsluhy použij window.addEventListener('popstate', handleState). Nepovažuj popstate za možnost zrušit navigaci.
Příklad záměrně vyvolá syntetickou událost PopStateEvent s pevným stavem. Ověřuje propojení atributu s Window, ale nemění historii ani netestuje skutečné procházení historie. CSP aplikace může blokovat atributy inline obsluhy; v takovém případě obsluhu zaregistruj v povoleném skriptu.
Příklady
<!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>Výsledek
step=1
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.