CKTIS / HTML
onpagereveal — gérer l’affichage de la page
L’attribut onpagereveal placé sur body définit le gestionnaire de l’événement pagereveal de l’objet Window. Cet événement se produit lorsque le document commence à être rendu après son initialisation ou sa réactivation.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<body onpagereveal="JavaScript statements">onpagereveal est un attribut de gestionnaire d’événement placé sur body. Sa valeur contient des instructions JavaScript, et non un nom d’événement. Bien qu’il soit écrit sur body, il gère l’événement pagereveal de l’objet Window, et non un événement local à cet élément.
Le navigateur déclenche pagereveal une fois par activation du document : lors du rendu initial et après une réactivation. Ce n’est ni un événement déclenché à chaque image ni un remplacement de load. Le navigateur peut afficher auparavant une image mise en cache ; le gestionnaire n’est donc pas garanti de s’exécuter avant l’apparition des premiers pixels de la page.
L’objet événement est un PageRevealEvent. Sa propriété viewTransition fait référence à la transition interdocument associée ou vaut null ; l’événement lui-même n’exige pas d’animation de transition. Les alternatives à l’attribut sont window.onpagereveal = handler et window.addEventListener('pagereveal', handler).
Quand le gestionnaire de l’exemple s’exécute, il écrit event.type (pagereveal) dans l’attribut data-received de l’élément body via document.body.dataset.received. Il ne modifie pas le texte visible. Les deux valeurs true dans la sortie de la console indiquent que body possède l’attribut onpagereveal et que window expose la propriété onpagereveal. Elles ne confirment pas que le gestionnaire s’est exécuté. Pour que le gestionnaire puisse s’exécuter, le navigateur doit implémenter l’événement et autoriser les gestionnaires d’événement définis directement dans le HTML ; une politique de sécurité peut les bloquer.
Exemples
<!doctype html>
<html lang="en">
<head><meta charset="utf-8"><title>Body onpagereveal handler</title></head>
<body onpagereveal="document.body.dataset.received = event.type">
<script>
console.log('onpagereveal attribute present: ' + document.body.hasAttribute('onpagereveal'));
console.log('onpagereveal event property available: ' + ('onpagereveal' in window));
</script>
</body>
</html>
Résultat
onpagereveal attribute present: true onpagereveal event property available: 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.