Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje