CKTIS / HTML
onpagereveal — gestión de la visualización de la página
El atributo onpagereveal de body establece el controlador del evento pagereveal del objeto Window. El evento se produce cuando el documento comienza a renderizarse después de su inicialización o reactivación.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
<body onpagereveal="JavaScript statements">onpagereveal es un atributo de controlador de eventos que se coloca en body. Su valor contiene instrucciones JavaScript, no el nombre de un evento. Aunque se escribe en body, controla el evento pagereveal del objeto Window, no un evento local de ese elemento.
El navegador activa pagereveal una vez por cada activación del documento: durante el renderizado inicial y después de una reactivación. No es un evento que se produzca en cada fotograma ni sustituye a load. El navegador puede mostrar antes un fotograma almacenado en caché, por lo que no se garantiza que el controlador se ejecute antes de que aparezca ningún píxel de la página.
El objeto del evento es un PageRevealEvent. Su propiedad viewTransition hace referencia a la transición entre documentos asociada o vale null; el evento en sí no requiere una animación de transición. Las alternativas al atributo son window.onpagereveal = handler y window.addEventListener('pagereveal', handler).
Cuando se ejecuta el controlador del ejemplo, escribe event.type (pagereveal) en el atributo data-received del elemento body mediante document.body.dataset.received. No modifica el texto visible. Los dos valores true de la salida de la consola indican que body tiene el atributo onpagereveal y que window expone la propiedad onpagereveal. No confirman que el controlador se haya ejecutado. Para que pueda ejecutarse, el navegador debe implementar el evento y permitir los controladores de eventos en línea; una política de seguridad puede bloquearlos.
Ejemplos
<!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>
Resultado
onpagereveal attribute present: true onpagereveal event property available: true
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.