CKTIS / HTML
onpageshow — gestire la visualizzazione di una pagina
L’attributo onpageshow su body associa codice JavaScript all’evento pageshow dell’oggetto Window. Gestisce sia la visualizzazione di un documento appena caricato sia la nuova visualizzazione di un documento conservato durante la navigazione nella cronologia.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
<body onpageshow="JavaScript code">onpageshow è un attributo per la gestione degli eventi scritto sull’elemento body. Il suo valore è codice JavaScript, non un valore booleano. Nonostante la sua posizione nel markup, gestisce l’evento pageshow dell’oggetto Window, non un normale evento dell’elemento body.
Per un documento appena caricato, pageshow si verifica dopo load. Si verifica anche quando un documento conservato viene visualizzato di nuovo durante la navigazione nella cronologia. Il parametro event è un PageTransitionEvent: event.persisted è false per un documento appena caricato e true per un documento riutilizzato. Il solo uso del pulsante Indietro non garantisce true, perché il browser potrebbe caricare nuovamente il documento.
L’attributo su body e la proprietà window.onpageshow si riferiscono allo stesso gestore di eventi; non considerarli due spazi indipendenti per funzioni. Un’alternativa è window.addEventListener('pageshow', handler), che consente di aggiungere gestori indipendenti. Una Content Security Policy può bloccare il codice negli attributi.
L’esempio sostituisce il testo del paragrafo con informazioni su event.persisted. Aprendo il file come nuovo documento, il testo previsto è pageshow: persisted=false. Se lo stesso documento viene ripristinato dalla cache back/forward, il testo previsto è pageshow: persisted=true; il ripristino non è garantito.
Esempi
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>onpageshow example</title>
</head>
<body onpageshow="document.getElementById('status').textContent = 'pageshow: persisted=' + event.persisted">
<p id="status">Waiting for pageshow</p>
</body>
</html>Risultato
pageshow: persisted=false
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.