CKTIS / HTML
onpageshow — obsluha zobrazení stránky
Atribut onpageshow na body přiřazuje kód JavaScriptu události pageshow objektu Window. Obsluhuje jak zobrazení nově načteného dokumentu, tak opětovné zobrazení zachovaného dokumentu při procházení historie.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<body onpageshow="JavaScript code">onpageshow je atribut pro obsluhu události zapsaný na prvku body. Jeho hodnotou je kód JavaScriptu, nikoli logická hodnota. Přestože je umístěn v tomto místě značky, obsluhuje událost pageshow objektu Window, nikoli běžnou událost prvku body.
U nově načteného dokumentu nastane pageshow po události load. Nastane také tehdy, když se při procházení historie znovu zobrazí zachovaný dokument. Parametr event je objekt PageTransitionEvent: event.persisted má hodnotu false u nově načteného dokumentu a true u znovu použitého dokumentu. Samotné použití tlačítka Zpět hodnotu true nezaručuje, protože prohlížeč může dokument načíst znovu.
Atribut na body a vlastnost window.onpageshow odkazují na stejnou obsluhu události; nepovažujte je za dvě nezávislá místa pro funkce. Alternativou je window.addEventListener('pageshow', handler), který umožňuje přidávat nezávislé obsluhy. Content Security Policy může blokovat kód v atributech.
Příklad nahradí text odstavce informací o event.persisted. Při otevření souboru jako nového dokumentu má být výsledný text pageshow: persisted=false. Při obnovení stejného dokumentu z mezipaměti back/forward má být výsledný text pageshow: persisted=true; obnovení není zaručeno.
Pří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ýsledek
pageshow: persisted=false
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.