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

CKTIS / HTML

onpagehide — obsluha opustenia stránky

Atribút onpagehide na prvku body registruje obslužnú rutinu udalosti pagehide objektu Window. Pri udalosti vyvolanej prehliadačom hodnota true vlastnosti event.persisted vyjadruje zámer prehliadača uchovať dokument na možné opätovné použitie, nie to, že ho skutočne uchová.

Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

<body onpagehide="JavaScript statements">

onpagehide je atribút obslužnej rutiny udalosti pagehide. Ak je umiestnený na body, obsluhuje udalosť objektu Window, nie udalosť obmedzenú na tento prvok. Nie je to globálny atribút dostupný na ľubovoľných prvkoch. Štandard ho sprístupňuje aj na historickom prvku frameset. Jeho hodnota obsahuje príkazy JavaScriptu; objekt udalosti je dostupný ako event.

Udalosť pagehide sa týka opustenia stránky, nie iba prepnutia karty. Pri udalosti vyvolanej prehliadačom má vlastnosť persisted objektu PageTransitionEvent hodnotu false, keď sa dokument opúšťa definitívne, a true, keď ho prehliadač zamýšľa uchovať na možné opätovné použitie, napríklad vo vyrovnávacej pamäti pre navigáciu späť/vpred (bfcache). Hodnota true nezaručuje, že sa dokument skutočne uchová ani že sa neskôr obnoví.

Ekvivalentom v JavaScripte je window.onpagehide = handler; priradenie nahradí predchádzajúcu obslužnú rutinu tejto vlastnosti. window.addEventListener('pagehide', handler) umožňuje registrovať nezávislé poslucháče. Príklad vyvolá syntetickú udalosť, aby bol výstup opakovateľný: stránku neopúšťa ani ju neumiestňuje do bfcache.

Prí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ýsledok

pagehide: persisted=true

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje