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

CKTIS / JavaScript

Življenjski cikel strani: vidnost, odhod in vrnitev

Loči skrit zavihek, poskus zapustitve strani in obnovitev iz predpomnilnika za pomikanje nazaj in naprej, da pravočasno shraniš stanje, opozoriš ali nadaljuješ delo.

Različica: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

document.addEventListener('visibilitychange', onVisibilityChange); // Read document.visibilityState or document.hidden.
window.addEventListener('beforeunload', onBeforeUnload); // Register only while unsaved changes exist.
window.removeEventListener('beforeunload', onBeforeUnload); // Remove the same listener once changes are saved or discarded.
window.addEventListener('pagehide', onPageHide); // Read event.persisted.
window.addEventListener('pageshow', onPageShow); // Read event.persisted.

Ti štirje dogodki so del spletne platforme, ne ECMAScripta 2024. Podpora in vedenje sta odvisna od brskalnika in okoliščin. Ne predpostavljaj, da se bodo vsi štirje dogodki sprožili v določenem vrstnem redu.

Poslušaj visibilitychange na document. Tega dogodka ni mogoče preklicati. Preberi document.visibilityState (visible ali hidden) ali logično vrednost document.hidden. Preklop zavihka lahko skrije stran, ne da bi jo zapustil. Sproti shranjuj stanje in uporabi prehod v hidden kot najboljši znak za zadnje shranjevanje ali začasno ustavitev dela, ne kot dokaz, da je seja končana.

beforeunload na window je preklicljiv dogodek tipa BeforeUnloadEvent, povezan s poskusom zapustitve, ponovnega nalaganja ali zaprtja strani. Če želiš zahtevati potrditev, pokliči event.preventDefault() in za združljivost s starejšimi brskalniki nastavi event.returnValue na neprazen niz. Vrnjena vrednost obravnavalnika učinkuje le pri onbeforeunload, ne pri addEventListener(). Pogovorno okno zahteva ustrezno predhodno interakcijo uporabnika (sticky activation); brskalnik ga lahko izpusti in sam določi njegovo besedilo. Poslušalnik dodaj samo ob neshranjenih spremembah in ga odstrani, ko jih shraniš ali zavržeš: lahko prepreči uporabo bfcache, med drugim v Firefoxu.

pagehide in pageshow sta dogodka tipa PageTransitionEvent na window, ki ju ni mogoče preklicati. Ob odhodu pagehide z event.persisted === true pomeni, da namerava brskalnik dokument obdržati v pomnilniku za pomikanje nazaj in naprej (bfcache), ne pa, da ga bo zagotovo obnovil. false pomeni, da ga ne namerava obdržati. Uporabi pagehide za začasno ustavitev dela z viri, ne za shranjevanje ključnih podatkov: ta dogodek in beforeunload se morda ne sprožita, na primer ko mobilni operacijski sistem konča brskalnik v ozadju.

Ob prvem nalaganju sledi pageshow dogodku load in ima persisted === false. Vrednost true pomeni, da je bil isti dokument dejansko obnovljen iz bfcache: nadaljuj začasno ustavljeno delo in osveži podatke, ki so morda zastareli. pageshow ne pomeni, da uporabnik vidi stran; lahko se sproži tudi na zavihku v ozadju.

Primeri

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Page lifecycle events</title>
</head>
<body>
  <label><input id="dirty" type="checkbox" autocomplete="off"> Simulate unsaved changes</label>
  <script>
    const dirty = document.getElementById('dirty');

    function warn(event) {
      console.log('beforeunload');
      event.preventDefault();
      event.returnValue = 'unsaved'; // Legacy compatibility, not dialog text.
    }

    dirty.addEventListener('change', () => {
      if (dirty.checked) {
        window.addEventListener('beforeunload', warn);
      } else {
        window.removeEventListener('beforeunload', warn);
      }
    });

    document.addEventListener('visibilitychange', () => {
      console.log(`visibilitychange: ${document.visibilityState}`);
    });
    for (const type of ['pagehide', 'pageshow']) {
      window.addEventListener(type, (event) => {
        console.log(`${type}: persisted=${event.persisted}`);
      });
    }
    console.log('ready');
  </script>
</body>
</html>

Rezultat

ready

Then, for example, after switching away from the tab and back:
visibilitychange: hidden
visibilitychange: visible

Other lines (not guaranteed and not in a fixed cross-event order):
beforeunload
pagehide: persisted=true
pageshow: persisted=true

A dispatched page transition event can also report persisted=false.

Odpri primer kot stran HTML v brskalniku in poglej v konzolo. `ready` se izpiše takoj; nadaljnji izpisi so odvisni od tvojih dejanj in brskalnika. Potrditveno polje ponazori neshranjene spremembe, vendar ničesar ne shrani.

Povezane lekcije

  • JavaScript · Lekcija 35 · Napredna · Različica: 4

Viri