English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية
$ .ajax()方法执行异步HTTP(Ajax)请求。
$.ajax() метод является основой для всех Ajax-запросов jQuery. Обычно не нужно напрямую вызывать этот метод, так как можно использовать$.get(),$.post()иload()и несколько других более сложных альтернатив, которые легче использовать. Однако, если нужно меньше обычных опций, $.ajax() можно использовать более гибко.
Грамматика之一:Версия 1.5+:
$.ajax(url, {name:value, name:value, ...})
Грамматика之二 :1.0+Версия:
$.ajax(name:value, name:value, ...)
ИспользуяДобавитьAJAX запросаВерсияИзменение текста элемента DIV:Версия 1.5:
$.ajax("ajax_intro.txt", {success: function(response){ $("div").html(response); });Проверьте, посмотрите < / >
ИспользуяДобавитьAJAX запросаВерсияИзменение текста элемента DIV:1.0Версия:
$.ajax({ url: "ajax_intro.txt", success: function(response){ $("div").html(response); } });Проверьте, посмотрите < / >
Запрос на страницу "ajax_get.php" и отправка некоторых других данных:
$.ajax({ url: "ajax_get.php", data: {fname:"Seagull", lname:"Anna"}, success: function(response){ $("div").html(response); } });Проверьте, посмотрите < / >
Запрос на страницу "ajax_get.php", отправка некоторых других данных и отображение сообщения о статусе:
$.ajax({ url: "ajax_get.php", data: {fname:"Seagull", lname:"Anna"}, success: function(response, status){ $("div").html(response); alert(status); } });Проверьте, посмотрите < / >
Запрос на страницу "ajax_post.php" через HTTP POST метод:
$.ajax({ url: "ajax_post.php", method: "POST", success: function(response){ $("div").html(response); } });Проверьте, посмотрите < / >
Использование параметра асинхронности для指定 синхронного запроса:
$.ajax({ url: "ajax_get.php", async: false, data: {fname:"Seagull", lname:"Anna"}, success: function(response){ $("div").html(response); } });Проверьте, посмотрите < / >
Использование параметра dataType для запроса указанного типа данных:
$.ajax({ url: "/javascript/myscript.js", dataType: "script" });Проверьте, посмотрите < / >
Если Ajax-запрос встречает ошибку, будет отображено уведомление:
$.ajax({ url: "wrong_file.html", success: function(response){ $("div").html(response); }, error: function(xhr){ $("div").html("Ошибка: " + xhr.status + " " + xhr.statusText); } });Проверьте, посмотрите < / >
Запрос файла и уведомление пользователя по завершении. Если запрос失败, будет отображено уведомление:
let request = $.ajax({ url: "ajax_get.php", data: {fname:"Seagull", lname:"Anna"} }); request.done(function(msg){ $("div").html(msg); }); request.fail(function(xhr, textStatus){ $("div").html("Запрос не удался: " + textStatus); });Проверьте, посмотрите < / >
Параметр указывает один или несколько name:value пар для AJAX-запроса.
Возможные имена: значения в таблице ниже:
Имя | Тип значения | Описание |
---|---|---|
async | Булево | Булевое значение, указывающее, следует ли обрабатывать запрос асинхронно. По умолчанию установлено в true |
beforeSend(xhr) | Функция | Функция, выполняемая перед отправкой запроса |
cache | Булево | Булевое значение, указывающее, следует ли браузеру кэшировать запрашиваемую страницу. По умолчанию установлено в true |
complete(xhr,status) | Функция | Функция, выполняемая после завершения запроса (после успешной и ошибочной функции) |
contentType | Булево значение или строка | Тип содержимого, используемый при отправке данных на сервер. По умолчанию установлено в “application / x-www-form-urlencoded” |
context | Обычный объект | Указание значения this для всех回调-функций, связанных с AJAX |
data | PlainObject или String или Array | Указание данных, которые следует отправить на сервер |
dataFilter(data,type) | Функция | Функция, используемая для обработки исходных данных XMLHttpRequest |
dataType | Строка | Тип данных, ожидаемый в ответе сервера |
error(xhr,status,error) | Функция | Функция, выполняемая при失败 запроса |
global | Булево | Булевое значение, указывающее, следует ли вызывать глобальный обработчик событий AJAX для запроса. По умолчанию установлено в true |
ifModified | Булево | Булевое значение, указывающее, следует ли считывать запрос успешным только в том случае, если ответ с последнего запроса изменился. По умолчанию установлено в false. |
jsonp | Строка или булево значение | Перекрытие функции回调 jsonp-запросов |
jsonpCallback | Функция | Указание имени функции回调 для jsonp-запросов |
method | Строка | Указание HTTP-метода, используемого для запроса. (Получение или发布). По умолчанию установлено в GET |
password | Строка | Указание пароля, используемого для запроса аутентификации HTTP. |
processData | Булево | Булевое значение, указывающее, следует ли преобразовывать данные, отправляемые вместе с запросом, в строку запроса.По умолчанию установлено в true |
scriptCharset | Строка | Указать код набора символов запроса |
statusCode | Обычный объект | Объект, который вызывается при наличии соответствующего кода ответа, содержит цифровой код HTTP и функцию$.ajax({ statusCode: { 404: function() { alert(“Невозможно найти страницу”); } } ) |
success(response,status,xhr) | Функция | Функция, которая должна быть выполнена при успешном выполнении запроса |
timeout | Число | Локальное время ожидания запроса (в миллисекундах) |
traditional | Булево | Булево значение, определяющее следует ли использовать традиционную последовательность параметров |
type | Строка | methodАльтернативное имя. Если вы используете версию jQuery 1.9.0 или более раннюю, используйте type |
url | Строка | Указать URL, на который будет отправлен запрос. По умолчанию это текущая страница |
username | Строка | Указать имя пользователя, которое должно использоваться в запросах аутентификации HTTP |
xhr | Функция | Функция для создания объекта XMLHttpRequest |