WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

onpagereveal — Behandlung der Seitenanzeige

Das Attribut onpagereveal auf body legt den Handler für das pagereveal-Ereignis des Window-Objekts fest. Das Ereignis tritt auf, wenn das Dokument nach der Initialisierung oder Reaktivierung mit dem Rendern beginnt.

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

Syntax

<body onpagereveal="JavaScript statements">

onpagereveal ist ein Ereignis-Handler-Attribut auf body. Sein Wert enthält JavaScript-Anweisungen, keinen Ereignisnamen. Obwohl das Attribut auf body steht, behandelt es das pagereveal-Ereignis des Window-Objekts und kein lokales Ereignis dieses Elements.

Der Browser löst pagereveal einmal pro Dokumentaktivierung aus: beim anfänglichen Rendern und nach einer Reaktivierung. Es handelt sich weder um ein Ereignis für jedes einzelne Bild noch um einen Ersatz für load. Der Browser kann zuvor ein zwischengespeichertes Bild anzeigen. Daher ist nicht garantiert, dass der Handler ausgeführt wird, bevor Pixel der Seite erscheinen.

Das Ereignisobjekt ist ein PageRevealEvent. Seine Eigenschaft viewTransition verweist auf den zugehörigen dokumentübergreifenden Übergang oder hat den Wert null; das Ereignis selbst erfordert keine Übergangsanimation. Alternativen zum Attribut sind window.onpagereveal = handler und window.addEventListener('pagereveal', handler).

Wenn der Handler im Beispiel ausgeführt wird, schreibt er event.type (pagereveal) über document.body.dataset.received in das Attribut data-received des Elements body. Sichtbarer Text ändert sich dadurch nicht. Die beiden true-Werte in der gezeigten Konsolenausgabe zeigen, dass body das Attribut onpagereveal besitzt und window die Eigenschaft onpagereveal bereitstellt. Sie bestätigen nicht, dass der Handler ausgeführt wurde. Damit der Handler ausgeführt werden kann, muss der Browser das Ereignis implementieren und direkt im HTML definierte Ereignis-Handler zulassen; eine Sicherheitsrichtlinie kann sie blockieren.

Beispiele

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

Ergebnis

onpagereveal attribute present: true
onpagereveal event property available: true

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