CKTIS / JavaScript
Udalosti wheel, pagehide, pageshow a beforeunload
Rozlíšte gesto kolieskom alebo touchpadom od posúvania, rozpoznajte obnovenie stránky z vyrovnávacej pamäte histórie a varujte pred stratou neuložených zmien.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
element.addEventListener("wheel", onWheel, { passive: true });
window.addEventListener("pagehide", onPageHide);
window.addEventListener("pageshow", onPageShow);
window.addEventListener("beforeunload", onBeforeUnload);
window.removeEventListener("beforeunload", onBeforeUnload);Tieto udalosti patria do API prehliadača, nie do ECMAScriptu 2024. Udalosť wheel odoberajte na prvku a udalosti pagehide, pageshow a beforeunload na window. Podrobnosti správania sa medzi prehliadačmi líšia.
wheel (WheelEvent) hlási gesto kolieskom myši alebo touchpadom, nie skutočný posun obsahu: gesto môže zmeniť priblíženie alebo nič neposunúť, kým posúvať sa dá aj klávesnicou. deltaX a deltaY opisujú gesto; deltaMode určuje jednotku: 0 pre pixely, 1 pre riadky a 2 pre strany. Skutočný posun zistíte porovnaním hodnôt scrollLeft a scrollTop v poslucháči scroll. Na samotné sledovanie použite { passive: true }. Ak potrebujete zabrániť predvolenému posunu alebo priblíženiu, použite { passive: false } a volajte preventDefault() len vtedy, keď event.cancelable je true. Niektoré prehliadače umožňujú zrušiť len prvú udalosť v sérii.
pagehide a pageshow majú typ PageTransitionEvent. Pri opustení stránky pagehide s persisted: true znamená, že stránka môže zostať vo vyrovnávacej pamäti pre navigáciu späť a dopredu (bfcache), nie že sa neskôr určite obnoví. pageshow s persisted: true znamená, že tá istá stránka bola obnovená z bfcache; pri prvom načítaní nasleduje pageshow po load a má persisted: false. Ani jedna udalosť nesleduje bežné prepínanie kariet a pageshow nedokazuje, že je stránka viditeľná. preventDefault() tieto prechody nezastaví.
beforeunload (BeforeUnloadEvent) môže nastať pred zatvorením, opätovným načítaním alebo opustením stránky. Zavolajte preventDefault(), ak chcete požiadať o potvrdenie; kvôli starším prehliadačom nastavte tiež event.returnValue na neprázdny reťazec. Vrátenie neprázdneho reťazca z obslužnej funkcie je starší mechanizmus pre onbeforeunload, nie pre addEventListener(). Dialóg vyžaduje predchádzajúcu interakciu používateľa (trvalú aktiváciu), jeho zobrazenie nie je zaručené a text určuje prehliadač.
Poslucháča beforeunload pridávajte len pri neuložených zmenách a po ich uložení alebo zahodení ho odstráňte. Ani pagehide, ani beforeunload nie sú spoľahlivé, najmä na mobilných zariadeniach. Ukladajte priebežne a použite visibilitychange na document pri document.visibilityState === "hidden" ako ďalší podnet na uloženie, nie ako dôkaz ukončenia relácie.
Príklady
(() => {
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}`);
})();Výsledok
wheel: deltaY=3, deltaMode=1, canceled=true pagehide: persisted=true pageshow: persisted=true beforeunload: dispatchEvent returned false
Spustite kód v konzole prehliadača alebo v Node.js 24. V prehliadači smeruje syntetická udalosť `wheel` na prvok nepripojený k dokumentu. V Node.js prvok nahrádza `EventTarget` a vlastnosti udalostí `wheel`, `pagehide` a `pageshow` sa pridávajú k bežným objektom `Event`. V oboch prostrediach zastupuje `window` samostatný `EventTarget`. `false` znamená zrušenie testovacej udalosti, nie zastavenie navigácie. Kód neposúva stránku, neobnovuje ju z bfcache ani neotvára dialóg.
Súvisiace lekcie
- JavaScript · Lekcia 36 · Pokročilá · Verzia: 4
Zdroje
- 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