Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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