Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje