CKTIS / HTML
onpageshow — obravnavanje prikaza strani
Atribut onpageshow na body dodeli kodo JavaScript dogodku pageshow objekta Window. Obravnava tako prikaz na novo naloženega dokumenta kot ponovni prikaz ohranjenega dokumenta med krmarjenjem po zgodovini.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<body onpageshow="JavaScript code">onpageshow je atribut za obravnavo dogodkov, zapisan na elementu body. Njegova vrednost je koda JavaScript, ne logična vrednost. Kljub mestu v oznaki obravnava dogodek pageshow objekta Window, ne običajnega dogodka elementa body.
Pri na novo naloženem dokumentu se pageshow zgodi po dogodku load. Zgodi se tudi, ko se med krmarjenjem po zgodovini znova prikaže ohranjen dokument. Parameter event je objekt PageTransitionEvent: event.persisted je false pri na novo naloženem dokumentu in true pri ponovno uporabljenem dokumentu. Sam pritisk gumba Nazaj ne zagotavlja vrednosti true, saj lahko brskalnik dokument znova naloži.
Atribut na body in lastnost window.onpageshow se nanašata na isti obravnavalnik dogodka; ne obravnavaj ju kot dveh neodvisnih mest za funkcije. Druga možnost je window.addEventListener('pageshow', handler), ki omogoča dodajanje neodvisnih obravnavalnikov. Content Security Policy lahko blokira kodo v atributih.
Primer zamenja besedilo odstavka z informacijami o event.persisted. Če datoteko odpreš kot nov dokument, je pričakovano besedilo pageshow: persisted=false. Če se isti dokument obnovi iz predpomnilnika back/forward, je pričakovano besedilo pageshow: persisted=true; obnova ni zagotovljena.
Primeri
<!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>Rezultat
pageshow: persisted=false
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.