CKTIS / HTML
onpopstate — gestire le modifiche alla voce attiva della cronologia
L’attributo onpopstate di body imposta il gestore dell’evento popstate dell’oggetto Window. Permette a una pagina di reagire alla navigazione nella cronologia della sessione, per esempio con Indietro e Avanti, e di leggere lo stato della voce di destinazione.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
<body onpopstate="handleState(event)">
window.onpopstate = handleState;onpopstate è un attributo gestore di eventi disponibile su body, non un attributo globale per elementi qualsiasi. Espone il gestore popstate dell’oggetto Window. L’assegnazione window.onpopstate = handleState imposta lo stesso gestore; non crea un secondo listener indipendente.
popstate è associato alla navigazione nella cronologia della sessione, per esempio tramite Indietro, Avanti o history.back(). La sola chiamata a history.pushState() o history.replaceState() non attiva l’evento. Nel gestore, event.state contiene lo stato ripristinato della voce di destinazione. Può essere null, quindi tienine conto prima di accedere alle sue proprietà.
Una successiva assegnazione a window.onpopstate sostituisce il gestore precedente; assegnare null lo rimuove. Per gestori indipendenti, usa window.addEventListener('popstate', handleState). Non considerare popstate un modo per annullare la navigazione.
L’esempio invia deliberatamente un evento sintetico PopStateEvent con uno stato fisso. Verifica il collegamento dell’attributo a Window, ma non modifica la cronologia né prova una navigazione effettiva al suo interno. La CSP di un’applicazione può bloccare gli attributi gestore inline; in tal caso, registra il gestore in uno script consentito.
Esempi
<!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>Risultato
step=1
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.