CKTIS / HTML
onpageshow — obsluha zobrazenia stránky
Atribút onpageshow na body priraďuje kód JavaScriptu k udalosti pageshow objektu Window. Obsluhuje zobrazenie novo načítaného dokumentu aj opätovné zobrazenie zachovaného dokumentu pri navigácii v histórii.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<body onpageshow="JavaScript code">onpageshow je atribút na obsluhu udalosti zapísaný na prvku body. Jeho hodnotou je kód JavaScriptu, nie logická hodnota. Napriek umiestneniu v značke obsluhuje udalosť pageshow objektu Window, nie bežnú udalosť prvku body.
Pri novo načítanom dokumente nastane pageshow po udalosti load. Nastane aj vtedy, keď sa počas navigácie v histórii znova zobrazí zachovaný dokument. Parameter event je objekt PageTransitionEvent: event.persisted má hodnotu false pri novo načítanom dokumente a true pri opätovne použitom dokumente. Samotné použitie tlačidla Späť hodnotu true nezaručuje, pretože prehliadač môže dokument znova načítať.
Atribút na body a vlastnosť window.onpageshow odkazujú na tú istú obsluhu udalosti; nepovažujte ich za dve nezávislé miesta pre funkcie. Alternatívou je window.addEventListener('pageshow', handler), ktorý umožňuje pridávať nezávislé obsluhy. Content Security Policy môže blokovať kód v atribútoch.
Príklad nahradí text odseku informáciou o event.persisted. Po otvorení súboru ako nového dokumentu má byť výsledný text pageshow: persisted=false. Pri obnovení toho istého dokumentu z vyrovnávacej pamäte back/forward má byť výsledný text pageshow: persisted=true; obnovenie nie je zaručené.
Príklady
<!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>Výsledok
pageshow: persisted=false
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.