CKTIS / HTML
onpagehide — obsługa zdarzenia opuszczania strony
Atrybut onpagehide elementu body rejestruje procedurę obsługi zdarzenia pagehide obiektu Window. W zdarzeniu wygenerowanym przez przeglądarkę wartość event.persisted równa true wskazuje na zamiar zachowania dokumentu do ewentualnego ponownego użycia, a nie na jego faktyczne zachowanie.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
<body onpagehide="JavaScript statements">onpagehide jest atrybutem obsługi zdarzenia pagehide. Umieszczony na elemencie body obsługuje zdarzenie obiektu Window, a nie zdarzenie dotyczące wyłącznie tego elementu. Nie jest atrybutem globalnym dostępnym na dowolnym elemencie. Standard udostępnia go także na historycznym elemencie frameset. Wartość atrybutu zawiera instrukcje JavaScript; obiekt zdarzenia jest dostępny jako event.
Zdarzenie pagehide dotyczy opuszczania strony, nie zwykłego przełączenia karty. W zdarzeniu wygenerowanym przez przeglądarkę właściwość persisted obiektu PageTransitionEvent ma wartość false, gdy dokument jest opuszczany na stałe, a true, gdy przeglądarka zamierza zachować dokument do ewentualnego ponownego użycia, na przykład w pamięci podręcznej nawigacji wstecz/dalej (bfcache). Wartość true nie gwarantuje ani faktycznego zachowania dokumentu, ani jego późniejszego przywrócenia.
Odpowiednikiem w JavaScript jest window.onpagehide = handler; przypisanie zastępuje poprzednią procedurę tej właściwości. window.addEventListener('pagehide', handler) pozwala rejestrować niezależne procedury. Przykład wysyła zdarzenie syntetyczne, aby wynik był powtarzalny: nie opuszcza strony ani nie umieszcza jej w bfcache.
Przykłady
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onpagehide demo</title>
<body onpagehide="document.getElementById('result').textContent = event.type + ': persisted=' + event.persisted">
<output id="result">Waiting</output>
<script>
window.dispatchEvent(new PageTransitionEvent('pagehide', {
persisted: true
}));
</script>
</body>
</html>Wynik
pagehide: persisted=true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.