База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Събитията wheel, pagehide, pageshow и beforeunload

Разграничавай жестовете с колелцето или тъчпада от превъртането, разпознавай възстановяване от кеша за навигация и предупреждавай за незапазени промени.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

element.addEventListener("wheel", onWheel, { passive: true });
window.addEventListener("pagehide", onPageHide);
window.addEventListener("pageshow", onPageShow);
window.addEventListener("beforeunload", onBeforeUnload);
window.removeEventListener("beforeunload", onBeforeUnload);

Тези събития са част от API на браузъра, а не от ECMAScript 2024. Слушай за wheel върху елемент, а за pagehide, pageshow и beforeunload — върху window. Някои подробности в поведението се различават между браузърите.

wheel (WheelEvent) отчита жест с колелцето на мишката или тъчпада, а не действително превъртане: жестът може да промени мащаба или да не премести нищо, а превъртане е възможно и с клавиатурата. deltaX и deltaY описват жеста; deltaMode определя единицата: 0 за пиксели, 1 за редове и 2 за страници. За да установиш действително движение, сравнявай стойностите на scrollLeft и scrollTop при обработка на scroll. За наблюдение използвай { passive: true }. Ако трябва да спреш превъртането или промяната на мащаба по подразбиране, използвай { passive: false } и извикай preventDefault() само ако event.cancelable е true. Някои браузъри позволяват да отмениш само първото събитие от поредицата.

pagehide и pageshow са от тип PageTransitionEvent. При напускане на страницата pagehide с persisted: true означава, че страницата може да остане в кеша за навигация назад и напред (bfcache), но по-късното възстановяване не е гарантирано. pageshow с persisted: true означава, че същата страница е възстановена от bfcache; при първоначално зареждане pageshow следва load и има persisted: false. Нито едно от двете събития не следи обикновеното превключване между раздели, а pageshow не доказва, че страницата е видима. preventDefault() не спира тези преходи.

beforeunload (BeforeUnloadEvent) може да възникне преди затваряне, презареждане или напускане на страницата. Извикай preventDefault(), за да поискаш потвърждение; за съвместимост със стари браузъри задай и непразен низ на event.returnValue. Връщането на непразен низ от обработчика е стар механизъм за onbeforeunload, а не за addEventListener(). Диалогът изисква предходно взаимодействие на потребителя (трайно активиране), не е гарантиран и показва текст, определен от браузъра.

Добавяй слушател за beforeunload само при незапазени промени и го премахвай след запазването или отхвърлянето им. Нито pagehide, нито beforeunload са надеждни, особено на мобилни устройства. Запазвай напредъка по време на работа и използвай visibilitychange върху document при document.visibilityState === "hidden" като допълнителен сигнал за запазване, а не като доказателство за край на сесията.

Примери

(() => {
  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}`);
})();

Резултат

wheel: deltaY=3, deltaMode=1, canceled=true
pagehide: persisted=true
pageshow: persisted=true
beforeunload: dispatchEvent returned false

Изпълни кода в конзолата на браузъра или в Node.js 24. В браузъра синтетичното събитие `wheel` се изпраща до елемент извън документа. В Node.js обект `EventTarget` замества елемента, а свойствата на `wheel`, `pagehide` и `pageshow` се добавят към обикновени обекти `Event`. И в двете среди отделен `EventTarget` замества `window`. `false` означава, че тестовото събитие е отменено, а не че навигацията е спряна. Кодът не превърта страницата, не я възстановява от bfcache и не отваря диалог.

Свързани уроци

  • JavaScript · Урок 36 · Напреднало · Версия: 4

Източници