CKTIS / HTML
onpagereveal — tratamento da apresentação da página
O atributo onpagereveal em body define o processador do evento pagereveal do objeto Window. O evento ocorre quando o documento começa a ser renderizado após a inicialização ou reativação.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
<body onpagereveal="JavaScript statements">onpagereveal é um atributo de processamento de eventos colocado em body. O seu valor contém instruções JavaScript, não o nome de um evento. Embora esteja escrito em body, processa o evento pagereveal do objeto Window, e não um evento local desse elemento.
O navegador dispara pagereveal uma vez por ativação do documento: durante a renderização inicial e após uma reativação. Não é um evento que ocorra a cada fotograma nem substitui load. O navegador pode apresentar previamente um fotograma guardado em cache, pelo que não é garantido que o processador seja executado antes de aparecerem píxeis da página.
O objeto do evento é um PageRevealEvent. A sua propriedade viewTransition refere-se à transição entre documentos associada ou tem o valor null; o evento, por si só, não exige uma animação de transição. As alternativas ao atributo são window.onpagereveal = handler e window.addEventListener('pagereveal', handler).
Quando é executado, o processador do exemplo escreve event.type (pagereveal) no atributo data-received do elemento body através de document.body.dataset.received. Não altera o texto visível. Os dois valores true apresentados na consola indicam que body tem o atributo onpagereveal e que a propriedade onpagereveal está disponível em window. Não confirmam que o processador foi executado. Para que o processador possa ser executado, o navegador tem de implementar o evento e permitir a execução de processadores de eventos definidos diretamente no HTML; uma política de segurança pode bloqueá-los.
Exemplos
<!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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.