Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

onpageswap — gestire un documento in uscita durante la navigazione

L’attributo onpageswap su body imposta il gestore Window per l’evento pageswap. Questo evento riguarda il documento in uscita durante la navigazione; non segnala la comparsa di una nuova pagina.

Versione: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintassi

<body onpageswap="JavaScript statements">

onpageswap è un attributo di contenuto che contiene codice JavaScript per un gestore dell’evento pageswap. Sull’elemento body configura il gestore di Window, non un gestore indipendente dell’elemento. Non è un attributo booleano: il suo valore è codice e il parametro event fornisce l’evento.

Il browser può inviare pageswap alla finestra del documento in uscita quando il documento cessa di essere attivo a causa della navigazione. Non è necessario che il documento venga rimosso dalla memoria: l’evento può verificarsi anche quando il browser lo conserva nella cache di navigazione avanti e indietro (bfcache). L’evento reale usa l’interfaccia PageSwapEvent; la sua proprietà viewTransition può fornire una transizione di visualizzazione oppure avere valore null. Non confondere questo evento con pagereveal, che riguarda l’inizio della visualizzazione di un documento. pageswap non serve ad annullare una navigazione.

L’attributo su body e la proprietà window.onpageswap configurano lo stesso gestore: assegnare una nuova funzione sostituisce quella precedente. L’alternativa window.addEventListener('pageswap', handler) aggiunge gestori indipendenti senza sostituire tale proprietà. La Content Security Policy può bloccare il codice negli attributi; in tal caso, usa uno script esterno consentito.

Lo script dell’esempio mostra nella console soltanto l’esito di due controlli: se body ha l’attributo onpageswap e se window espone la proprietà onpageswap. Lo script non genera alcun evento e non avvia una navigazione, quindi il risultato non conferma che il gestore definito nell’attributo venga eseguito.

Esempi

<!doctype html>
<html lang="en">
<head><meta charset="utf-8"><title>Body onpageswap handler</title></head>
<body onpageswap="document.body.dataset.received = event.type">
  <script>
    console.log('onpageswap attribute present: ' + document.body.hasAttribute('onpageswap'));
    console.log('onpageswap event property available: ' + ('onpageswap' in window));
  </script>
</body>
</html>

Risultato

onpageswap attribute present: true
onpageswap event property available: true

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.

Fonti