Spec-Zone.ru › jQuery

Событие ajaxStop

.on( "ajaxStop", handler )Возвращает: jQuery

Описание: Регистрирует обработчик, который вызывается, когда все запросы Ajax завершены. Это событие Ajax.

  • версия добавлена: 1.7.on( "ajaxStop", handler )

    • "ajaxStop"
      Тип: строка
      Строка "ajaxStop".
    • handler
      Тип: Функция()
      Функция, которая будет вызвана.

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

Всякий раз, когда запрос Ajax завершается, jQuery проверяет, есть ли другие незавершенные запросы Ajax. Если их нет, jQuery вызывает событие ajaxStop. Все зарегистрированные обработчики ajaxStop выполняются в этот момент. Событие ajaxStop также вызывается, если последний незавершенный запрос Ajax отменён возвращением false внутри функции обратного вызова beforeSend.

Чтобы наблюдать за этим методом в действии, настройте базовый запрос загрузки Ajax:

<div class="trigger">Trigger</div>
<div class="result"></div>
<div class="log"></div>

Прикрепите обработчик события к документу:

$( document ).on( "ajaxStop", function() {
  $( ".log" ).text( "Triggered ajaxStop handler." );
} );

Теперь сделайте запрос Ajax с помощью любого метода jQuery:

$( ".trigger" ).on( "click", function() {
  $( ".result" ).load( "ajax/test.html" );
} );

Когда пользователь кликает по элементу с классом trigger и запрос Ajax завершается, сообщение в журнале отображается.

Дополнительные заметки:

  • Начиная с jQuery 1.9, все обработчики глобальных событий Ajax jQuery, включая добавленные с помощью .on( "ajaxStop", ... ), должны быть прикреплены к document.
  • Если $.ajax() или $.ajaxSetup() вызывается с опцией global установленной в значение false, событие ajaxStop не будет срабатывать.

Пример:

Скрыть сообщение о загрузке после того, как все запросы Ajax завершены.

$( document ).on( "ajaxStop", function() {
  $( "#loading" ).hide();
} );

© The jQuery Foundation and other contributors
Licensed under the MIT License.
https://api.jquery.com/ajaxStop

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API