CKTIS / JavaScript
Životný cyklus stránky: viditeľnosť, opustenie a návrat
Rozlíš skrytie karty, pokus o opustenie stránky a obnovenie z vyrovnávacej pamäte pri navigácii späť alebo dopredu, aby si v správnej chvíli ukladal stav, varoval alebo pokračoval v práci.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
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.Tieto štyri udalosti patria k webovej platforme, nie k ECMAScriptu 2024. Podpora a správanie závisia od prehliadača a situácie. Nespoliehaj sa, že všetky udalosti nastanú v pevnom poradí.
Počúvaj visibilitychange na document. Túto udalosť nemožno zrušiť. Prečítaj document.visibilityState (visible alebo hidden) alebo logickú hodnotu document.hidden. Prepnutie karty môže skryť stránku bez jej opustenia. Ukladaj stav priebežne a prechod na hidden ber ako najlepší signál na posledné uloženie alebo pozastavenie práce, nie ako dôkaz skončenia relácie.
beforeunload na window je zrušiteľná udalosť typu BeforeUnloadEvent spojená s pokusom opustiť, znova načítať alebo zavrieť stránku. Ak chceš požiadať o potvrdenie, zavolaj event.preventDefault() a kvôli kompatibilite so staršími prehliadačmi nastav event.returnValue na neprázdny reťazec. Vrátenie hodnoty z obslužnej funkcie funguje len cez onbeforeunload, nie cez addEventListener(). Dialóg vyžaduje predchádzajúcu vhodnú interakciu používateľa (sticky activation); prehliadač ho môže potlačiť a určuje jeho text. Obsluhu pridaj len pri neuložených zmenách a odstráň ju po ich uložení alebo zahodení: jej prítomnosť môže zabrániť použitiu bfcache, okrem iného vo Firefoxe.
pagehide a pageshow sú nezrušiteľné udalosti typu PageTransitionEvent na window. Pri opustení stránky znamená pagehide s event.persisted === true, že prehliadač chce uchovať dokument v pamäti na navigáciu späť alebo dopredu (bfcache), nie že ho určite obnoví. false znamená, že ho uchovať nechce. Používaj pagehide na pozastavenie práce so zdrojmi, nie na ukladanie kritických údajov: táto udalosť aj beforeunload nemusia nastať, napríklad keď mobilný operačný systém ukončí prehliadač na pozadí.
Pri prvom načítaní nasleduje pageshow po load s persisted === false. Hodnota true znamená, že ten istý dokument bol skutočne obnovený z bfcache: pokračuj v pozastavenej práci a aktualizuj prípadne neaktuálne údaje. pageshow neznamená, že používateľ stránku vidí; môže nastať aj na karte na pozadí.
Príklady
<!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>Výsledok
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.
Otvor príklad ako stránku HTML v prehliadači a pozri sa do konzoly. `ready` sa zobrazí hneď; ďalšie výpisy závisia od tvojich akcií a prehliadača. Začiarkavacie políčko simuluje neuložené zmeny, ale nič neukladá.
Súvisiace lekcie
- JavaScript · Lekcia 35 · Pokročilá · Verzia: 4