Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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