WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

onpageshow — Anzeigen einer Seite behandeln

Das Attribut onpageshow auf body weist JavaScript-Code dem pageshow-Ereignis des Window-Objekts zu. Es behandelt sowohl das Anzeigen eines neu geladenen Dokuments als auch das erneute Anzeigen eines erhaltenen Dokuments bei der Navigation im Verlauf.

Version: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

<body onpageshow="JavaScript code">

onpageshow ist ein Ereignisbehandlungsattribut, das im Element body steht. Sein Wert ist JavaScript-Code, kein boolescher Wert. Trotz seiner Position im Markup behandelt es das pageshow-Ereignis des Window-Objekts und kein gewöhnliches Ereignis des Elements body.

Bei einem neu geladenen Dokument tritt pageshow nach load auf. Es tritt auch auf, wenn bei der Navigation im Verlauf ein erhaltenes Dokument erneut angezeigt wird. Der Parameter event ist ein PageTransitionEvent: event.persisted ist bei einem neu geladenen Dokument false und bei einem wiederverwendeten Dokument true. Allein durch die Verwendung der Zurück-Schaltfläche ist true nicht garantiert, da der Browser das Dokument erneut laden kann.

Das Attribut auf body und die Eigenschaft window.onpageshow beziehen sich auf denselben Ereignisbehandler; behandle sie nicht als zwei unabhängige Plätze für Funktionen. Eine Alternative ist window.addEventListener('pageshow', handler), mit der unabhängige Behandler hinzugefügt werden können. Eine Content Security Policy kann Code in Attributen blockieren.

Das Beispiel ersetzt den Absatztext durch eine Angabe zu event.persisted. Wird die Datei als neues Dokument geöffnet, sollte pageshow: persisted=false angezeigt werden. Wird dasselbe Dokument aus dem Back/Forward-Cache wiederhergestellt, sollte pageshow: persisted=true angezeigt werden; eine Wiederherstellung ist nicht garantiert.

Beispiele

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

Ergebnis

pageshow: persisted=false

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen