CKTIS / HTML
onpagereveal — obrada prikaza stranice
Atribut onpagereveal na body postavlja rukovatelj događaja pagereveal objekta Window. Događaj se javlja kada se dokument počne iscrtavati nakon inicijalizacije ili ponovne aktivacije.
Verzija: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<body onpagereveal="JavaScript statements">onpagereveal je atribut rukovatelja događaja postavljen na body. Njegova vrijednost sadrži JavaScript naredbe, a ne naziv događaja. Iako je zapisan na body, obrađuje događaj pagereveal objekta Window, a ne lokalni događaj tog elementa.
Preglednik pokreće pagereveal jednom po aktivaciji dokumenta: tijekom početnog iscrtavanja i nakon ponovne aktivacije. To nije događaj za svaki kadar niti zamjena za load. Preglednik može prethodno prikazati predmemorirani kadar pa nije zajamčeno da će se rukovatelj izvršiti prije nego što se pojavi ijedan piksel stranice.
Objekt događaja je PageRevealEvent. Njegovo svojstvo viewTransition odnosi se na povezani prijelaz između dokumenata ili ima vrijednost null; sam događaj ne zahtijeva animaciju prijelaza. Alternative atributu su window.onpagereveal = handler i window.addEventListener('pagereveal', handler).
Kad se rukovatelj u primjeru izvrši, putem document.body.dataset.received upisuje vrijednost event.type (pagereveal) u atribut data-received elementa body. Ne mijenja vidljivi tekst. Dvije vrijednosti true u prikazanom ispisu konzole znače da body ima atribut onpagereveal i da je svojstvo onpagereveal dostupno na objektu window. Ne potvrđuju da se rukovatelj izvršio. Da bi se rukovatelj mogao izvršiti, preglednik mora implementirati događaj i dopustiti izvršavanje rukovatelja događajima zapisanih izravno u HTML-u; sigurnosna ih politika može blokirati.
Primjeri
<!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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.