CKTIS / HTML
onpagereveal — obravnavanje prikaza strani
Atribut onpagereveal na body nastavi obravnavo dogodka pagereveal objekta Window. Dogodek se sproži, ko se dokument po inicializaciji ali ponovni aktivaciji začne izrisovati.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<body onpagereveal="JavaScript statements">onpagereveal je atribut za obravnavo dogodkov na elementu body. Njegova vrednost vsebuje stavke JavaScript, ne imena dogodka. Čeprav je zapisan na body, obravnava dogodek pagereveal objekta Window, ne pa lokalnega dogodka tega elementa.
Brskalnik sproži pagereveal enkrat ob vsaki aktivaciji dokumenta: med začetnim izrisom in po ponovni aktivaciji. To ni dogodek za vsak posamezen okvir in ne nadomešča dogodka load. Brskalnik lahko pred tem prikaže predpomnjen okvir, zato ni zagotovljeno, da se bo obravnavalnik izvedel, preden se prikažejo prvi piksli strani.
Objekt dogodka je PageRevealEvent. Njegova lastnost viewTransition se nanaša na povezani prehod med dokumentoma ali ima vrednost null; sam dogodek ne zahteva animacije prehoda. Alternativi atributu sta window.onpagereveal = handler in window.addEventListener('pagereveal', handler).
Ko se obravnavalnik v primeru izvede, prek document.body.dataset.received zapiše vrednost event.type (pagereveal) v atribut data-received elementa body. Vidno besedilo se ne spremeni. Vrednosti true v prikazanem izpisu konzole pomenita, da ima body atribut onpagereveal in da je na objektu window na voljo lastnost onpagereveal. Ne potrjujeta, da se je obravnavalnik izvedel. Da se lahko izvede, mora brskalnik podpirati dogodek in dovoliti izvajanje obravnavalnikov, zapisanih neposredno v HTML; varnostna politika jih lahko blokira.
Primeri
<!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>
Rezultat
onpagereveal attribute present: true onpagereveal event property available: true
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.