CKTIS / HTML
onpageshow — gérer l’affichage d’une page
L’attribut onpageshow de body associe du code JavaScript à l’événement pageshow de l’objet Window. Il traite aussi bien l’affichage d’un document nouvellement chargé que le réaffichage d’un document conservé lors de la navigation dans l’historique.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<body onpageshow="JavaScript code">onpageshow est un attribut de gestion d’événement écrit sur l’élément body. Sa valeur est du code JavaScript, et non une valeur booléenne. Malgré son emplacement dans le balisage, il traite l’événement pageshow de l’objet Window, et non un événement ordinaire de l’élément body.
Pour un document nouvellement chargé, pageshow se produit après load. Il se produit aussi lorsqu’un document conservé est réaffiché lors de la navigation dans l’historique. Le paramètre event est un PageTransitionEvent : event.persisted vaut false pour un document nouvellement chargé et true pour un document réutilisé. Le simple fait d’utiliser le bouton Précédent ne garantit pas la valeur true, car le navigateur peut recharger le document.
L’attribut sur body et la propriété window.onpageshow désignent le même gestionnaire d’événement ; ne les considère pas comme deux emplacements indépendants pour des fonctions. Une autre possibilité est window.addEventListener('pageshow', handler), qui permet d’ajouter des gestionnaires indépendants. Une Content Security Policy peut bloquer le code dans les attributs.
L’exemple remplace le texte du paragraphe par une information sur event.persisted. Si le fichier est ouvert comme un nouveau document, le texte attendu est pageshow: persisted=false. Si le même document est restauré depuis le cache back/forward, le texte attendu est pageshow: persisted=true ; cette restauration n’est pas garantie.
Exemples
<!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>Résultat
pageshow: persisted=false
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.