Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

onpageshow — gestionar la visualización de una página

El atributo onpageshow de body asigna código JavaScript al evento pageshow del objeto Window. Gestiona tanto la visualización de un documento recién cargado como la de un documento conservado que vuelve a mostrarse al navegar por el historial.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

<body onpageshow="JavaScript code">

onpageshow es un atributo de gestión de eventos que se escribe en el elemento body. Su valor es código JavaScript, no un valor booleano. Aunque aparece en esa ubicación del marcado, gestiona el evento pageshow del objeto Window, no un evento normal del elemento body.

En un documento recién cargado, pageshow ocurre después de load. También ocurre cuando un documento conservado vuelve a mostrarse al navegar por el historial. El parámetro event es un PageTransitionEvent: event.persisted es false para un documento recién cargado y true para uno reutilizado. Usar el botón Atrás no garantiza por sí solo que sea true, ya que el navegador puede volver a cargar el documento.

El atributo de body y la propiedad window.onpageshow hacen referencia al mismo controlador de eventos; no los trates como dos espacios independientes para funciones. Una alternativa es window.addEventListener('pageshow', handler), que permite añadir controladores independientes. Una Content Security Policy puede bloquear el código de los atributos.

El ejemplo sustituye el texto del párrafo por información sobre event.persisted. Al abrir el archivo como un documento nuevo, el texto esperado es pageshow: persisted=false. Si se restaura el mismo documento desde la caché back/forward, el texto esperado es pageshow: persisted=true; la restauración no está garantizada.

Ejemplos

<!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

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.

Fuentes