CKTIS / HTML
onpagehide — gérer le départ d’une page
L’attribut onpagehide sur body enregistre un gestionnaire pour l’événement pagehide de l’objet Window. Pour un événement généré par le navigateur, la valeur true de event.persisted indique que le navigateur prévoit de conserver le document en vue d’une éventuelle réutilisation, sans confirmer sa conservation effective.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<body onpagehide="JavaScript statements">onpagehide est un attribut de gestionnaire d’événement pour pagehide. Placé sur body, il gère l’événement sur Window, et non un événement limité à cet élément. Ce n’est pas un attribut global disponible sur n’importe quel élément. La norme le rend également disponible sur l’élément historique frameset. Sa valeur contient des instructions JavaScript ; l’objet événement est accessible sous le nom event.
L’événement pagehide concerne le départ d’une page, et pas simplement le changement d’onglet. Pour un événement généré par le navigateur, la propriété persisted de l’objet PageTransitionEvent vaut false lorsque le document est quitté définitivement, et true lorsque le navigateur prévoit de le conserver en vue d’une éventuelle réutilisation, par exemple dans le cache de navigation arrière/avant (bfcache). La valeur true ne garantit ni la conservation effective du document ni sa restauration ultérieure.
L’équivalent en JavaScript est window.onpagehide = handler ; cette affectation remplace le gestionnaire précédent de cette propriété. window.addEventListener('pagehide', handler) permet d’enregistrer des écouteurs indépendants. L’exemple déclenche un événement synthétique pour obtenir un résultat reproductible : il ne quitte pas la page et ne la place pas dans le bfcache.
Exemples
<!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>Résultat
pagehide: persisted=true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.