CKTIS / HTML
onpagereveal — de paginaverschijning afhandelen
Het attribuut onpagereveal op body stelt de handler in voor de pagereveal-gebeurtenis van het Window-object. De gebeurtenis treedt op wanneer het document na initialisatie of heractivering begint te renderen.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<body onpagereveal="JavaScript statements">onpagereveal is een gebeurtenishandlerattribuut op body. De waarde bevat JavaScript-instructies, geen gebeurtenisnaam. Hoewel het attribuut op body staat, handelt het de pagereveal-gebeurtenis van het Window-object af, niet een lokale gebeurtenis van dat element.
De browser activeert pagereveal eenmaal per documentactivatie: tijdens de eerste weergave en na heractivering. Het is geen gebeurtenis voor elk afzonderlijk frame en geen vervanging voor load. De browser kan vooraf een eerder opgeslagen frame weergeven. Daarom is het niet gegarandeerd dat de handler wordt uitgevoerd voordat er pixels van de pagina verschijnen.
Het gebeurtenisobject is een PageRevealEvent. De eigenschap viewTransition verwijst naar de bijbehorende overgang tussen documenten of heeft de waarde null; de gebeurtenis zelf vereist geen overgangsanimatie. Alternatieven voor het attribuut zijn window.onpagereveal = handler en window.addEventListener('pagereveal', handler).
Wanneer de handler in het voorbeeld wordt uitgevoerd, schrijft hij event.type (pagereveal) via document.body.dataset.received naar het attribuut data-received van het element body. De zichtbare tekst verandert niet. De twee true-waarden in de getoonde console-uitvoer geven aan dat body het attribuut onpagereveal heeft en dat de eigenschap onpagereveal op window beschikbaar is. Ze bevestigen niet dat de handler is uitgevoerd. Om de handler te kunnen uitvoeren, moet de browser de gebeurtenis implementeren en inline gebeurtenishandlers toestaan; beveiligingsbeleid kan ze blokkeren.
Voorbeelden
<!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>
Resultaat
onpagereveal attribute present: true onpagereveal event property available: true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.