CKTIS / HTML
onpageshow — obsługa wyświetlenia strony
Atrybut onpageshow elementu body przypisuje kod JavaScript do zdarzenia pageshow obiektu Window. Obsługuje zarówno pokazanie nowo załadowanego dokumentu, jak i ponowne pokazanie zachowanego dokumentu podczas nawigacji w historii.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
<body onpageshow="JavaScript code">onpageshow to atrybut obsługi zdarzenia zapisywany na elemencie body. Jego wartością jest kod JavaScript, a nie wartość logiczna. Mimo miejsca zapisu obsługuje zdarzenie pageshow obiektu Window, nie zwykłe zdarzenie elementu body.
Przy nowym ładowaniu dokumentu pageshow następuje po load. Występuje również przy ponownym pokazaniu zachowanego dokumentu podczas nawigacji w historii. Parametr event jest obiektem PageTransitionEvent: event.persisted ma wartość false dla nowo ładowanego dokumentu oraz true dla ponownie użytego dokumentu. Samo użycie przycisku Wstecz nie gwarantuje wartości true, ponieważ przeglądarka może załadować dokument od nowa.
Atrybut na body oraz właściwość window.onpageshow odnoszą się do tej samej obsługi zdarzenia; nie traktuj ich jako dwóch niezależnych miejsc na funkcje. Alternatywą jest window.addEventListener('pageshow', handler), pozwalające dodawać niezależne procedury obsługi. Polityka bezpieczeństwa treści może blokować kod w atrybutach.
Przykład zastępuje tekst akapitu informacją o event.persisted. Po otwarciu pliku jako nowego dokumentu oczekiwany tekst to pageshow: persisted=false. Przy przywróceniu tego samego dokumentu z pamięci back/forward cache oczekiwany tekst to pageshow: persisted=true; przywrócenie nie jest gwarantowane.
Przykłady
<!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>Wynik
pageshow: persisted=false
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.