unload event — jQuery

Привяжите обработчик событий к событию "unload" или вызовите это событие на элементе.

Содержание:

.on( "unload" [, eventData ], handler )
- .on( "unload" [, eventData ], handler )
.trigger( "unload" )
- .trigger( "unload" )

.on( "unload" [, eventData ], handler )Возвращает: jQuery

Описание: Привязывает обработчик событий к событию "unload".

версия добавлена: 1.7.on( "unload" [, eventData ], handler )
- "unload"
  
  Тип: строка
  
  Строка "unload".
- eventData
  
  Тип: Любое
  
  Простой объект данных, который будет передан обработчику событий.
- handler
  
  Тип: Функция( Событие eventObject )
  
  Функция, которая выполняется каждый раз при срабатывании события.

Эта страница описывает событие unload. Для метода .unload(), удаленного в jQuery 3.0, см. .unload().

Событие unload отправляется элементу window, когда пользователь покидает страницу. Это может означать множество вещей. Пользователь может нажать на ссылку, чтобы покинуть страницу, или ввести новый URL в адресной строке. Кнопки "Назад" и "Вперёд" также вызовут это событие. Закрытие окна браузера также вызовет это событие. Даже перезагрузка страницы сначала создаст событие unload.

Точное поведение события unload различалось в разных версиях браузеров. Например, некоторые версии Firefox вызывали событие при переходе по ссылке, но не при закрытии окна. В практическом применении следует тестировать поведение на всех поддерживаемых браузерах и сравнивать его с похожим событием beforeunload.

Любой обработчик события unload должен быть привязан к объекту window.

$( window ).on( "unload", function() {
  return "Handler for `unload` called.";
} );

Это событие предоставляется для того, чтобы скрипты могли выполнить очистку при выходе пользователя со страницы. Большинство браузеров проигнорируют вызовы alert(), confirm() и prompt() внутри обработчика события. Возвращаемая вами строка может быть использована в диалоговом окне подтверждения, но не все браузеры поддерживают это. Отменить событие unload с помощью .preventDefault() нельзя.

Пример:

Чтобы отобразить всплывающее окно при выходе с страницы:

$( window ).on( "unload", function() {
  return "Bye now!";
} );

.trigger( "unload" )Возвращает: jQuery

Описание: Вызывает событие "unload" на элементе.

версия добавлена: 1.0.trigger( "unload" )
- "unload"
  
  Тип: строка
  
  Строка "unload".

См. описание для .on( "unload", ... ).

событие unload

Содержание:

.on( "unload" [, eventData ], handler )Возвращает: jQuery

версия добавлена: 1.7.on( "unload" [, eventData ], handler )

Пример:

.trigger( "unload" )Возвращает: jQuery

версия добавлена: 1.0.trigger( "unload" )