Описание функции jQuery.post(параметры) AJAX запроса методом POST.
jQuery.post( url [, data ] [, success(data, textStatus, jqXHR) ] [, dataType ] ) — отправляет запрос на сервер POST запрос.
Входные параметры
- url — строка адреса, по которому посылается запрос, обязательный параметр.
- data — данные, посылаемые на сервер запросом, параметр необязательный. Представляют собой строку или пары ключ:значение(«plain object» в терминах jQuery).
- success(data, textStatus, jqXHR) — callback функция, выполняемая в случае успешного выполнения запроса. При вызове ей передаются возвращаемые данные, текстовая строка состояния запроса и объект jqXHR, реализующий AJAX запросы(детальнее об jqXHR можно узнать в описании возвращаемых параметров функции jQuery.ajax().
- dataType — строка, определяющая тип данных, ожидаемых от сервера, по умолчанию ожидается(xml, json, script, html).
Возвращаемое значение — объект jqXHR.
Функция очень похожа на предыдущую get, разница лишь в методе отправки содержимого AJAX запроса на сервер.
Примеры использования функции post().
Пример1 Наиболее распространенный вариант использования данной функции — AJAX запрос, в котором отправляются данные на сервер, а возвращаемый результат(data) добавляется на web страницу.
$.post('ajax/add_data.html', { name: "Василий", middle name: "Алибабаевич" },
function(data) {$('.result').html(data);}
);
Пример2 В примере методом POST отправляется запрос с данными, производится обработка принятой информации, в запросе определен тип JSON ожидаемых данных.
$.post("test.php",
{ name: "Имя", age: "25" },
function(data){ process(data;},
"json"
);