CKTIS / HTML
onpopstate — obravnavanje sprememb aktivnega vnosa v zgodovini
Atribut onpopstate elementa body nastavi obravnavo dogodka popstate objekta Window. Stran se tako lahko odzove na pomikanje po zgodovini seje, na primer z gumboma Nazaj in Naprej, ter prebere stanje ciljnega vnosa.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<body onpopstate="handleState(event)">
window.onpopstate = handleState;onpopstate je atribut za obravnavo dogodkov, ki je na voljo na elementu body, ne pa globalni atribut za poljubne elemente. Omogoča obravnavo popstate objekta Window. Z dodelitvijo window.onpopstate = handleState nastaviš isto obravnavo; s tem ne ustvariš drugega, neodvisnega poslušalca.
Dogodek popstate je povezan s pomikanjem po zgodovini seje, na primer z gumboma Nazaj in Naprej ali s klicem history.back(). Sam klic history.pushState() ali history.replaceState() dogodka ne sproži. V obravnavi event.state vsebuje obnovljeno stanje ciljnega vnosa. Lahko je null, zato to upoštevaj, preden dostopaš do njegovih lastnosti.
Poznejša dodelitev window.onpopstate nadomesti prejšnjo obravnavo, dodelitev null pa jo odstrani. Za neodvisne obravnave uporabi window.addEventListener('popstate', handleState). Dogodka popstate ne obravnavaj kot načina za preklic navigacije.
Primer namenoma sproži sintetični dogodek PopStateEvent s fiksnim stanjem. Preveri povezavo atributa z Window, vendar ne spremeni zgodovine in ne preizkusi dejanskega pomikanja po njej. CSP aplikacije lahko blokira atribute za inline obravnavo; v tem primeru obravnavo registriraj v dovoljenem skriptu.
Primeri
<!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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.