CKTIS / HTML
onpopstate — spracovanie zmien aktívnej položky histórie
Atribút onpopstate prvku body nastavuje obsluhu udalosti popstate objektu Window. Stránka tak môže reagovať na prechádzanie históriou relácie, napríklad pomocou tlačidiel Späť a Dopredu, a čítať stav cieľovej položky.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<body onpopstate="handleState(event)">
window.onpopstate = handleState;onpopstate je atribút obsluhy udalosti dostupný na prvku body, nie globálny atribút pre ľubovoľné prvky. Sprístupňuje obsluhu popstate objektu Window. Priradenie window.onpopstate = handleState nastaví tú istú obsluhu; nevytvorí druhý, nezávislý listener.
Udalosť popstate súvisí s prechádzaním históriou relácie, napríklad pomocou tlačidiel Späť a Dopredu alebo volaním history.back(). Samotné volanie history.pushState() alebo history.replaceState() túto udalosť nevyvolá. V obsluhe obsahuje event.state obnovený stav cieľovej položky. Môže mať hodnotu null, preto s tým počítaj pred prístupom k jeho vlastnostiam.
Neskoršie priradenie k window.onpopstate nahradí predchádzajúcu obsluhu a priradenie null ju odstráni. Pre nezávislé obsluhy použi window.addEventListener('popstate', handleState). Nepovažuj popstate za možnosť zrušiť navigáciu.
Príklad zámerne vyvolá syntetickú udalosť PopStateEvent s pevným stavom. Overuje prepojenie atribútu s Window, ale nemení históriu ani netestuje skutočné prechádzanie históriou. CSP aplikácie môže blokovať atribúty inline obsluhy; v takom prípade zaregistruj obsluhu v povolenom skripte.
Prí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ýsledok
step=1
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.