CKTIS / JavaScript
Dogodki wheel, pagehide, pageshow in beforeunload
Loči potezo s kolescem ali sledilno ploščico od dejanskega pomikanja, prepoznaj obnovitev strani iz predpomnilnika in opozori na neshranjene spremembe.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
element.addEventListener("wheel", onWheel, { passive: true });
window.addEventListener("pagehide", onPageHide);
window.addEventListener("pageshow", onPageShow);
window.addEventListener("beforeunload", onBeforeUnload);
window.removeEventListener("beforeunload", onBeforeUnload);Ti dogodki sodijo med API-je brskalnika, ne v ECMAScript 2024. Dogodek wheel poslušaj na elementu, dogodke pagehide, pageshow in beforeunload pa na window. Podrobnosti delovanja se med brskalniki razlikujejo.
wheel (WheelEvent) sporoča potezo z miškinim kolescem ali sledilno ploščico, ne dejanskega pomika: poteza lahko spremeni povečavo ali ne premakne ničesar, pomikaš pa se lahko tudi s tipkovnico. deltaX in deltaY opisujeta potezo; deltaMode določa enoto: 0 za slikovne pike, 1 za vrstice in 2 za strani. Za zaznavanje dejanskega pomika v poslušalcu scroll primerjaj vrednosti scrollLeft in scrollTop. Za samo opazovanje uporabi { passive: true }. Če moraš preprečiti privzeto pomikanje ali povečavo, uporabi { passive: false } in pokliči preventDefault() le, če je event.cancelable enak true. Nekateri brskalniki dovolijo preklic le prvega dogodka v zaporedju.
pagehide in pageshow sta tipa PageTransitionEvent. Ob odhodu s strani pagehide s persisted: true pomeni, da lahko stran ostane v predpomnilniku za pomikanje nazaj in naprej po zgodovini (bfcache), ne pa, da bo pozneje zagotovo obnovljena. pageshow s persisted: true pomeni, da se je izvajanje iste strani nadaljevalo po obnovitvi iz bfcache; ob prvem nalaganju pageshow sledi dogodku load in ima persisted: false. Nobeden ne zaznava običajnega preklapljanja zavihkov in pageshow ni dokaz, da je stran vidna. preventDefault() teh prehodov ne ustavi.
beforeunload (BeforeUnloadEvent) se lahko sproži pred zaprtjem, ponovnim nalaganjem ali odhodom s strani. S preventDefault() zahtevaj potrditveno pogovorno okno; za združljivost s starejšimi brskalniki nastavi tudi event.returnValue na neprazen niz. Vračanje nepraznega niza iz obravnavalnika je starejši mehanizem za onbeforeunload, ne za addEventListener(). Pogovorno okno zahteva predhodno dejanje uporabnika (trajno aktivacijo), njegov prikaz ni zagotovljen, besedilo pa določi brskalnik.
Poslušalca beforeunload dodaj samo ob neshranjenih spremembah in ga odstrani, ko jih shraniš ali zavržeš. Niti pagehide niti beforeunload nista zanesljiva, zlasti na mobilnih napravah. Delo shranjuj sproti, visibilitychange na document pri document.visibilityState === "hidden" pa uporabi kot dodaten znak za shranjevanje, ne kot dokaz konca seje.
Primeri
(() => {
const element = typeof document === "undefined"
? new EventTarget()
: document.createElement("div");
const page = new EventTarget();
element.addEventListener("wheel", (event) => {
const unit = event.deltaMode;
if (event.cancelable) event.preventDefault();
console.log(`wheel: deltaY=${event.deltaY}, deltaMode=${unit}, canceled=${event.defaultPrevented}`);
}, { passive: false });
const logTransition = (event) => {
console.log(`${event.type}: persisted=${event.persisted}`);
};
page.addEventListener("pagehide", logTransition);
page.addEventListener("pageshow", logTransition);
page.addEventListener("beforeunload", (event) => event.preventDefault());
const wheel = typeof WheelEvent === "function"
? new WheelEvent("wheel", {
deltaY: 3, deltaMode: WheelEvent.DOM_DELTA_LINE, cancelable: true
})
: Object.assign(new Event("wheel", { cancelable: true }), {
deltaY: 3, deltaMode: 1 // Lines, as with WheelEvent.DOM_DELTA_LINE.
});
const transition = (type) => typeof PageTransitionEvent === "function"
? new PageTransitionEvent(type, { persisted: true })
: Object.assign(new Event(type), { persisted: true });
element.dispatchEvent(wheel);
page.dispatchEvent(transition("pagehide"));
page.dispatchEvent(transition("pageshow"));
const result = page.dispatchEvent(new Event("beforeunload", { cancelable: true }));
console.log(`beforeunload: dispatchEvent returned ${result}`);
})();Rezultat
wheel: deltaY=3, deltaMode=1, canceled=true pagehide: persisted=true pageshow: persisted=true beforeunload: dispatchEvent returned false
Kodo zaženi v konzoli brskalnika ali v Node.js 24. V brskalniku je sintetični dogodek `wheel` poslan elementu, ki ni priključen dokumentu. V Node.js element nadomešča `EventTarget`, lastnosti dogodkov `wheel`, `pagehide` in `pageshow` pa so dodane navadnim objektom `Event`. V obeh okoljih ločen `EventTarget` nadomešča `window`. `false` pomeni, da je bil preizkusni dogodek preklican, ne da je bila navigacija ustavljena. Koda ne pomika strani, je ne obnovi iz bfcache in ne odpre pogovornega okna.
Povezane lekcije
- JavaScript · Lekcija 36 · Napredna · Različica: 4
Viri
- Element: wheel event
- WheelEvent: deltaMode property
- WheelEvent: WheelEvent() constructor
- Window: pagehide event
- Window: pageshow event
- HTML Standard: The PageTransitionEvent interface
- Window: beforeunload event
- HTML Standard: Preventing navigation
- Document: visibilitychange event
- EventTarget: dispatchEvent() method