CKTIS / HTML
onpageshow — tratar a apresentação de uma página
O atributo onpageshow em body associa código JavaScript ao evento pageshow do objeto Window. Trata tanto a apresentação de um documento acabado de carregar como a reapresentação de um documento preservado durante a navegação no histórico.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
<body onpageshow="JavaScript code">onpageshow é um atributo de tratamento de eventos escrito no elemento body. O seu valor é código JavaScript, não um valor booleano. Apesar da sua localização na marcação, trata o evento pageshow do objeto Window, e não um evento normal do elemento body.
Num documento acabado de carregar, pageshow ocorre depois de load. Também ocorre quando um documento preservado volta a ser apresentado durante a navegação no histórico. O parâmetro event é um PageTransitionEvent: event.persisted é false para um documento acabado de carregar e true para um documento reutilizado. Usar o botão Voltar, por si só, não garante o valor true, porque o navegador pode carregar novamente o documento.
O atributo em body e a propriedade window.onpageshow referem-se ao mesmo tratador de eventos; não os consideres dois espaços independentes para funções. Uma alternativa é window.addEventListener('pageshow', handler), que permite adicionar tratadores independentes. Uma Content Security Policy pode bloquear código em atributos.
O exemplo substitui o texto do parágrafo por informação sobre event.persisted. Ao abrir o ficheiro como um novo documento, o texto esperado é pageshow: persisted=false. Se o mesmo documento for restaurado da cache back/forward, o texto esperado é pageshow: persisted=true; a restauração não é garantida.
Exemplos
<!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>Resultado
pageshow: persisted=false
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.