jQuery метод .ajaxComplete()
Определение и применение
jQuery метод .ajaxComplete() позволяет задать функцию (обработчик события), которая вызывается после завершения
AJAX
запроса.
Если методы
$.ajax(), или $.ajaxSetup() используются с установленным параметром global со значением false, то
обработчик ajaxComplete не будет вызван. Начиная с версии jQuery 1.9, все обработчики для глобальных AJAX
событий, должны быть прикреплены к объекту document следующием образом:
$( document ).ajaxEvent( handler ) // пример добавления обработчика для глобального AJAX события
jQuery синтаксис:
Синтаксис 1.0:
.ajaxComplete( handler )handler - Function( Event event, jqXHR jqXHR, PlainObject ajaxOptions )
Добавлен в версии jQuery
1.0Значения параметров
| Параметр | Описание |
|---|---|
| handler |
Задает функцию, которая будет выполняться при завершении AJAX запроса. Является обязательным параметром
метода. Функция принимает следующие параметры:
|
Пример старого кода
Метод $.ajaxComplete() — пример 1
Нажмите . Используйте кнопки в результате и наблюдайте изменения. Измените JavaScript и запустите пример повторно. Используется jQuery 4.0.0.
index.html
<button>Клик</button><span></span> <br /><br />
<div></div>
main.js
$(document).ready(function () {
$('button').click(function () {
// задаем функцию при нажатиии на элемент <button>
$('div').load('message.html') // с использованием AJAX запроса загружаем данные с сервера и размещаем, возвращенный HTML код внутри элемента <div>
})
$(document).ajaxComplete(function (event, xhr, options) {
// добавляем обработчик события
if (options.url == 'message.html')
// если в объекте, содержащим настройки AJAX запроса ключ url содержит значение message.html
$('span').text("it's ajaxComplete") // то добавить в элемент <span> текстовое содержимое
})
})
style.css
body {
margin: 16px;
font:
16px/1.5 system-ui,
sans-serif;
overflow-wrap: anywhere;
}
img,
input,
select,
textarea,
button {
max-width: 100%;
}
Нажмите , чтобы запустить пример.
В этом примере с использованием jQuery метода .load() мы при нажатии на элемент
<button>
(кнопка) с использованием AJAX запроса загружаем данные с сервера и размещаем, возвращенный HTML код внутри элемента
<div>. Загружаемый файл ("message.html") содержит следующий HTML код:
<h1>Заголовок первого уровня</h1>
<p>Обычный параграф</p>
Кроме того, мы с использованием метода .ajaxComplete() задаем функцию (обработчик события), которая вызывается
после завершения AJAX запроса. Функция производит проверку на наличие в объекте, содержащего настройки
AJAX запроса ключа "url", который содержит значение message.html. Если содержит, то в элемент
<span>
с использованием метода
.text()
производит добавление текстового содержимого.
Пример использования jQuery метода .ajaxComplete()
Исходный код для изучения. Запуск на этой странице недоступен.
index.html
<button>Клик</button><span></span><br /><br />
<div></div>
main.js
$(document).ready(function () {
$('button').click(function () {
$('div').load('message.html')
})
$(document).ajaxComplete(function (event, xhr, options) {
if (options.url == 'message.html') $('span').text("it's ajaxComplete")
})
})