jQuery ajax - post() 方法

语法

1. jQuery.post(url, data, success(data,  textStatus,  jqXHR), dataType)

复制代码

参数	描述
url	必需。规定把请求发送到哪个 URL。
data	可选。映射或字符串值。规定连同请求发送到服务器的数据。
success(data, textStatus, jqXHR)	可选。请求成功时执行的回调函数。
dataType	可选。规定预期的服务器响应的数据类型。 默认执行智能判断（xml、json、script 或 html）。

详细说明

该函数是简写的 Ajax 函数，等价于：

1. $.ajax({
   
2.   type: 'POST',
   
3.   url: url,
   
4.   data: data,
   
5.   success: success,
   
6.   dataType: dataType
   
7. });

复制代码

jqXHR 对象
对于 jQuery 1.5，所有 jQuery 的 AJAX 方法返回的是 XMLHTTPRequest 对象的超集。由 $.post() 返回的 jQuery XHR 对象或 "jqXHR,"实现了约定的接口，赋予其所有的属性、方法，以及约定的行为。出于对由 $.ajax() 使用的回调函数名称便利性和一致性的考虑，它提供了 .error(), .success() 以及 .complete() 方法。这些方法使用请求终止时调用的函数参数，该函数接受与对应命名的 $.ajax() 回调函数相同的参数。
jQuery 1.5 中的约定接口同样允许 jQuery 的 Ajax 方法，包括 $.post()，来链接同一请求的多个 .success()、.complete() 以及 .error() 回调函数，甚至会在请求也许已经完成后分配这些回调函数。

1. // 请求生成后立即分配处理程序，请记住该请求针对 jqxhr 对象
   
2.     var jqxhr = $.post("example.php", function() {
   
3.       alert("success");
   
4.     })
   
5.     .success(function() { alert("second success"); })
   
6.     .error(function() { alert("error"); })
   
7.     .complete(function() { alert("complete"); });
   
8. 
   
9.     // 在这里执行其他任务
   
10.        
    
11.     // 为上面的请求设置另一个完成函数
    
12.     jqxhr.complete(function(){ alert("second complete"); });

复制代码

例子 1
请求 test.php 页面，并一起发送一些额外的数据（同时仍然忽略返回值）：

1. $.post("test.php", { name: "John", time: "2pm" } );

复制代码

例子 2
向服务器传递数据数组（同时仍然忽略返回值）：

1. $.post("test.php", { 'choices[]': ["Jon", "Susan"] });

复制代码

例子 3
使用 ajax 请求发送表单数据：

1. $.post("test.php", $("#testform").serialize());

复制代码

例子 4
输出来自请求页面 test.php 的结果（HTML 或 XML，取决于所返回的内容）：

1. $.post("test.php", function(data){
   
2.    alert("Data Loaded: " + data);
   
3. });

复制代码

例子 5
向页面 test.php 发送数据，并输出结果（HTML 或 XML，取决于所返回的内容）：

1. $.post("test.php", { name: "John", time: "2pm" },
   
2.    function(data){
   
3.      alert("Data Loaded: " + data);
   
4.    });

复制代码

例子 6
获得 test.php 页面的内容，并存储为 XMLHttpResponse 对象，并通过 process() 这个 JavaScript 函数进行处理：

1. $.post("test.php", { name: "John", time: "2pm" },
   
2.    function(data){
   
3.      process(data);
   
4.    }, "xml");

复制代码

例子 7
获得 test.php 页面返回的 json 格式的内容：

1. $.post("test.php", { "func": "getNameAndTime" },
   
2.    function(data){
   
3.      alert(data.name); // John
   
4.      console.log(data.time); //  2pm
   
5.    }, "json");

复制代码