CKTIS / HTML
onpagehide — obsluha opuštění stránky
Atribut onpagehide na prvku body registruje obslužnou rutinu události pagehide objektu Window. U události vyvolané prohlížečem hodnota true vlastnosti event.persisted vyjadřuje záměr prohlížeče uchovat dokument pro možné opětovné použití, nikoli to, že jej skutečně uchová.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<body onpagehide="JavaScript statements">onpagehide je atribut obslužné rutiny události pagehide. Pokud je umístěn na body, obsluhuje událost objektu Window, nikoli událost omezenou na tento prvek. Nejde o globální atribut dostupný na libovolných prvcích. Standard jej zpřístupňuje také na historickém prvku frameset. Jeho hodnota obsahuje příkazy JavaScriptu; objekt události je dostupný jako event.
Událost pagehide se týká opuštění stránky, nikoli pouhého přepnutí karty. U události vyvolané prohlížečem má vlastnost persisted objektu PageTransitionEvent hodnotu false, když se dokument opouští definitivně, a true, když jej prohlížeč zamýšlí uchovat pro možné opětovné použití, například v mezipaměti navigace zpět/vpřed (bfcache). Hodnota true nezaručuje, že se dokument skutečně uchová ani že se později obnoví.
Ekvivalentem v JavaScriptu je window.onpagehide = handler; přiřazení nahradí předchozí obslužnou rutinu této vlastnosti. window.addEventListener('pagehide', handler) umožňuje registrovat nezávislé posluchače. Příklad vyvolá syntetickou událost, aby byl výstup opakovatelný: stránku neopouští ani ji neumísťuje do bfcache.
Příklady
<!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>Výsledek
pagehide: persisted=true
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.