jQuery ajax()Метод
Методы AJAX jQueryПримеры
Используйте AJAX-запрос, чтобы изменить текст элемента <div>:
$("button").click(function(){
$.ajax({url:"demo_test.txt",success:function(result){
$("#div1").html(result);
}});
});
Попробуйте сами »
Определение и использование
Метод ajax() используется для выполнения AJAX-запроса (асинхронного HTTP-запроса).
Все методы jQuery AJAX используют метод ajax(). Этот метод обычно используется для запросов, которые не могут выполнить другие методы.
Синтаксис
$.ajax({name:value, name:value, ... })
Этот параметр задаёт одну или несколько пар имя/значение для AJAX-запроса.
В следующей таблице перечислены возможные пары имя/значение:
| Name | Значение/Описание |
|---|---|
| async | Логическое значение, указывающее, обрабатывается ли запрос асинхронно. Значение по умолчанию — true. |
| beforeSend(xhr) | Функция, выполняемая перед отправкой запроса. |
| cache | Логическое значение, указывающее, кэширует ли браузер запрошенную страницу. Значение по умолчанию — true. |
| complete(xhr,status) | Функция, выполняемая по завершении запроса (вызывается после функций success и error, то есть после функций success и error). |
| contentType | Тип содержимого, используемый при отправке данных на сервер. По умолчанию: "application/x-www-form-urlencoded". |
| context | Задаёт значение "this" для всех callback-функций, связанных с AJAX. |
| data | Задаёт данные, отправляемые на сервер. |
| dataFilter(data,type) | Функция для обработки необработанных данных ответа XMLHttpRequest. |
| dataType | Ожидаемый тип данных ответа сервера. |
| error(xhr,status,error) | Функция, выполняемая в случае неудачного запроса. |
| global | Логическое значение, указывающее, запускать ли глобальные обработчики событий AJAX для запроса. По умолчанию true. |
| ifModified | Логическое значение, указывающее, успешен ли запрос только если ответ изменился с момента последнего запроса. По умолчанию false. |
| jsonp | Строка для переопределения функции обратного вызова в jsonp. |
| jsonpCallback | Указывает имя функции обратного вызова в jsonp. |
| пароль | Указывает пароль для использования в запросе аутентификации доступа HTTP. |
| processData | Логическое значение, указывающее, преобразуются ли данные, отправляемые через запрос, в строку запроса. По умолчанию true. |
| scriptCharset | Указывает кодировку для запроса. |
| success(result,status,xhr) | Функция, выполняемая при успешном запросе. |
| timeout | Устанавливает локальный тайм-аут запроса (в миллисекундах). |
| традиционный | Логическое значение, указывающее, использовать ли традиционный стиль сериализации параметров. |
| type | Задает тип запроса (GET или POST). |
| url | Задает URL-адрес, на который отправляется запрос. По умолчанию — текущая страница. |
| username | Задает имя пользователя для использования в запросе HTTP-аутентификации. |
| xhr | Функция для создания объекта XMLHttpRequest. |
Другие примеры
Создание асинхронного AJAX-запроса
Как использовать параметр async для указания асинхронного запроса.
Создание AJAX-запроса с указанным типом данных
Как использовать параметр dataType для указания типа данных запроса.
Создайте AJAX-запрос с ошибками
Как использовать параметр error для обработки ошибок в AJAX-запросах.
Другие расширения