CKTIS / JavaScript
Događaji wheel, pagehide, pageshow i beforeunload
Razlikuj gestu kotačićem ili dodirnom pločicom od pomicanja sadržaja, prepoznaj povratak stranice iz predmemorije i upozori na nespremljene promjene.
Verzija: 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);Ovi događaji pripadaju API-jima preglednika, a ne ECMAScriptu 2024. Slušaj wheel na elementu, a pagehide, pageshow i beforeunload na window. Pojedinosti ponašanja razlikuju se među preglednicima.
wheel (WheelEvent) javlja gestu kotačićem miša ili dodirnom pločicom, a ne stvarni pomak sadržaja: gesta može promijeniti zumiranje ili ne pomaknuti ništa, dok se sadržaj može pomicati i tipkovnicom. deltaX i deltaY opisuju gestu; deltaMode određuje jedinicu: 0 za piksele, 1 za retke i 2 za stranice. Za otkrivanje stvarnog pomaka uspoređuj vrijednosti scrollLeft i scrollTop u slušaču događaja scroll. Za samo praćenje upotrijebi { passive: true }. Ako moraš spriječiti zadano pomicanje ili zumiranje, upotrijebi { passive: false } i pozovi preventDefault() samo ako je event.cancelable jednak true. Neki preglednici dopuštaju otkazivanje samo prvog događaja u nizu.
pagehide i pageshow tipa su PageTransitionEvent. Pri napuštanju stranice pagehide s persisted: true znači da stranica može ostati u predmemoriji za navigaciju natrag i naprijed (bfcache), ne da će kasnije sigurno biti vraćena. pageshow s persisted: true znači da je ista stranica vraćena iz bfcachea; pri prvom učitavanju pageshow slijedi nakon load i ima persisted: false. Nijedan događaj ne prati obično prebacivanje kartica, a pageshow ne dokazuje da je stranica vidljiva. preventDefault() ne zaustavlja te prijelaze.
beforeunload (BeforeUnloadEvent) može se pokrenuti prije zatvaranja, ponovnog učitavanja ili napuštanja stranice. Pozovi preventDefault() da zatražiš potvrdni dijalog; radi kompatibilnosti sa starijim preglednicima postavi i event.returnValue na neprazan niz znakova. Vraćanje nepraznog niza znakova iz funkcije za obradu stariji je mehanizam za onbeforeunload, a ne za addEventListener(). Dijalog zahtijeva prethodnu interakciju korisnika (trajnu aktivaciju), nije zajamčen i prikazuje tekst koji određuje preglednik.
Dodaj slušača za beforeunload samo dok postoje nespremljene promjene i ukloni ga nakon spremanja ili odbacivanja promjena. Ni pagehide ni beforeunload nisu pouzdani, osobito na mobilnim uređajima. Spremaj tijekom rada i koristi visibilitychange na document kad vrijedi document.visibilityState === "hidden" kao dodatan znak za spremanje, a ne kao dokaz da je sesija završila.
Primjeri
(() => {
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
Pokreni kôd u konzoli preglednika ili u Node.js 24. U pregledniku se sintetički događaj `wheel` šalje elementu koji nije povezan s dokumentom. U Node.js element zamjenjuje `EventTarget`, a svojstva događaja `wheel`, `pagehide` i `pageshow` dodaju se običnim objektima `Event`. U oba okruženja zaseban `EventTarget` zamjenjuje `window`. `false` znači da je otkazan probni događaj, a ne da je zaustavljena navigacija. Kôd ne pomiče stranicu, ne vraća je iz bfcachea i ne otvara dijalog.
Povezane lekcije
- JavaScript · Lekcija 36 · Napredno · Verzija: 4
Izvori
- 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