Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

onpagehide — gestire l’uscita da una pagina

L’attributo onpagehide su body registra un gestore per l’evento pagehide dell’oggetto Window. In un evento generato dal browser, il valore true di event.persisted indica che il browser intende conservare il documento per un possibile riutilizzo, non che lo conservi effettivamente.

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

Sintassi

<body onpagehide="JavaScript statements">

onpagehide è un attributo gestore di eventi per pagehide. Se inserito su body, gestisce l’evento su Window, non un evento limitato a quell’elemento. Non è un attributo globale disponibile su qualsiasi elemento. Lo standard lo rende disponibile anche sull’elemento storico frameset. Il suo valore contiene istruzioni JavaScript; l’oggetto evento è disponibile come event.

L’evento pagehide riguarda l’uscita da una pagina, non il semplice passaggio da una scheda all’altra. In un evento generato dal browser, la proprietà persisted dell’oggetto PageTransitionEvent vale false quando il documento viene abbandonato definitivamente e true quando il browser intende conservarlo per un possibile riutilizzo, per esempio nella cache di navigazione indietro/avanti (bfcache). Il valore true non garantisce né che il documento venga effettivamente conservato né che venga ripristinato in seguito.

L’equivalente JavaScript è window.onpagehide = handler; l’assegnazione sostituisce il gestore precedente di quella proprietà. window.addEventListener('pagehide', handler) permette di registrare gestori indipendenti. L’esempio invia un evento sintetico per ottenere un risultato ripetibile: non abbandona la pagina né la inserisce nel bfcache.

Esempi

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onpagehide demo</title>
<body onpagehide="document.getElementById('result').textContent = event.type + ': persisted=' + event.persisted">
  <output id="result">Waiting</output>
  <script>
    window.dispatchEvent(new PageTransitionEvent('pagehide', {
      persisted: true
    }));
  </script>
</body>
</html>

Risultato

pagehide: persisted=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