jQuery ajax - post() 方法

jQuery Ajax 参考手册

实例

请求 test.php 网页，忽略返回值：

$.post("test.php");

定义和用法

post() 方法通过远程 HTTP POST 请求载入信息。

这是一个简单的 POST 请求功能以取代复杂 $.ajax 。请求成功时可调用回调函数。如果需要在出错时执行函数，请使用 $.ajax。

语法 jQuery.post(url,[data],[callback],[type])

参数 描述

url 待载入页面的 URL 地址。

data 待发送 Key / value 参数。

callback 载入成功时回调函数。

type 返回内容格式，xml, html, script, json, text, _default。

详细说明

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

$.ajax({ type: 'POST', url: url, data: data, success: success, dataType: dataType });

根据响应的不同的 MIME 类型，传递给 success 回调函数的返回数据也有所不同，这些数据可以是 XML root 元素、文本字符串、JavaScript 文件或者 JSON 对象。也可向 success 回调函数传递响应的文本状态。

对于 jQuery 1.4，也可以向 success 回调函数传递 XMLHttpRequest 对象。

大部分实现会规定一个 success 函数：

$.post("ajax/test.html", function(data) { $(".result").html(data); });

本例读取被请求的 HTML 片段，并插入页面中。

通过 POST 读取的页面不被缓存，因此 jQuery.ajaxSetup() 中的 cache 和 ifModified 选项不会影响这些请求。

更多实例 例子 1

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

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

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

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

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

$.post("test.php", $("#testform").serialize()); 例子 4

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

$.post("test.php", function(data){ alert("Data Loaded: " + data); }); 例子 5

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

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

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

$.post("test.php", { name: "John", time: "2pm" }, function(data){ process(data); }, "xml"); 例子 7

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

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

jQuery Ajax 参考手册