Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / HTML

onpagehide — obravnava zapuščanja strani

Atribut onpagehide na elementu body registrira obravnavo dogodka pagehide objekta Window. Pri dogodku, ki ga sproži brskalnik, vrednost true lastnosti event.persisted pomeni, da namerava brskalnik dokument ohraniti za morebitno ponovno uporabo, ne pa, da ga dejansko ohrani.

Različica: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaksa

<body onpagehide="JavaScript statements">

onpagehide je atribut za obravnavo dogodka pagehide. Če je dodan elementu body, obravnava dogodek na objektu Window, ne pa dogodka, omejenega na ta element. Ne gre za globalni atribut, ki bi bil na voljo na poljubnih elementih. Standard ga omogoča tudi na zgodovinskem elementu frameset. Njegova vrednost vsebuje ukaze JavaScript; objekt dogodka je na voljo kot event.

Dogodek pagehide se nanaša na zapuščanje strani, ne zgolj na preklapljanje med zavihki. Pri dogodku, ki ga sproži brskalnik, ima lastnost persisted objekta PageTransitionEvent vrednost false, ko dokument dokončno zapustimo, in true, ko ga namerava brskalnik ohraniti za morebitno ponovno uporabo, na primer v predpomnilniku za pomik nazaj/naprej (bfcache). Vrednost true ne zagotavlja niti dejanske ohranitve dokumenta niti njegove poznejše obnovitve.

Ustreznica v JavaScriptu je window.onpagehide = handler; prirejanje nadomesti prejšnjo obravnavo v tej lastnosti. window.addEventListener('pagehide', handler) omogoča registracijo neodvisnih poslušalnikov. Primer sproži sintetični dogodek, da je rezultat ponovljiv: strani ne zapusti in je ne shrani v bfcache.

Primeri

<!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>

Rezultat

pagehide: persisted=true

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri