$.ajax(properties)
使用HTTP请求(XMLHttpRequest)载入一个远程页面。
这是jQuery的低级AJAX实现。要查看高级抽象,见$.set、$.post等。
$.ajax()返回创建好的XMLHttpRequest对象。多数情况下并不需要直接操纵这个对象,但是如果需要手动中止请求,它也是可用的。
注意:要确保服务器返回正确的MIME类型(例如:XML是“text/xml”)。如果返回了错误的MIME类型就会导致jQuery无法处理的严重问题。
支持的数据类型包括(见dataType选项):
"xml": 返回一个可以由jQuery对象处理的XML文档。
"html": 返回纯文本格式的HTML,包括求值后的脚本标记。
"script": 将响应作为Javascript语句求值,并返回纯文本。
"json": 将响应作为JSON求值,并返回一个Javascript对象。
$.ajax()带有一个参数--“名/值对”形式的一个对象,用于初始化和处理请求。以下就是可用的所有“名/值对”:
(String) url - 要将请求发送到的URL地址。
(String) type - 请求的类型("POST" 或 "GET"), 默认是 "GET"。
(String) dataType - 期望从服务器端返回的数据类型。无默认值:如果服务器返回XML,就将responseXML传递到回调函数,否则将resposeText传递到回调函数。
(Boolean) ifModified - 只有响应自上次请求后被修改过才承认是成功的请求。是通过检查头部的Last-Modified值实现的。默认值为false,即忽略 对部分的检查
(Number) timeout - 覆盖全局延迟的局部延迟,例如,在其他所有延迟经过1秒钟后,启动一个较长延迟的单独请求。有关全局延迟,见$.ajaxTimeout()。
(Boolean) global - 是否为当前的请求触发全局AJAX事件处理函数,默认值为true。设置为false可以防止触发像ajaxStart或ajaxStop这样的全局事件处理函数。
(Function) error - 当请求失败时调用的函数。这个函数会得到三个参数:XMLHttpRequest对象、一个描述所发生的错误类型的字符串和一个可选异常对象(如果有)。
(Function) success - 当请求成功时调用的函数。这个函数会得到一个参数:从服务器返回的数据(根据“dataType”进行了格式化)。
(Function) complete - 当请求完成时调用的函数。这个函数会得到两个参数:XMLHttpRequest对象和一个描述请求成功的类型的字符串。
(Object|String) data - 要发送到服务器的数据。如果还不是一个字符串,就自动轮换为一个查询字符串。即附加到GET请求的url后面的字符串。要防止自动处理见processData选项。
(String) contentType - 设置发送请求的content=type。默认值是 "application/x-www-form-urlencoded", 这个值能满足多数情况。
(Boolean) processData - 在默认的情况下,如果data选项传进的数据是一个对象而不是字符串,将会自动地被处理和转换成一个查询字符串,以适应默认的content-type--"application/x-www-form-urlencoded"。如果想发送DOMDocuments,就要把这个选项设置为false。
(Boolean) async - 在默认的情况下,所有请求都是以异步的方式发送的(值为true)。如果要使用同步方式,需要将此项设置为false。
(Function) beforeSend - 用于设置自定义头部等信息的预调用函数,接收一个唯一的参数--XMLHttpRequest对象。
返回值:XMLHttpRequest
参数:
· properties (Map): Key/valuepairs to initialize the request with.
载入并执行一个JavaScript文件。
$.ajax({
type: "GET",
url: "test.js",
dataType: "script"
})
示例:
将数据保存到服务器,并在保存完成后通报用户。
$.ajax({
type: "POST",
url: "some.php",
data: "name=John&location=Boston",
success: function(msg){ alert( "DataSaved: " + msg ); }
});
示例:
同步载入数据。当请求处于活动期间阻塞浏览器。如果必须同步载入数据,最好是通过其他手段来阻止用户的交互,而不是阻塞整个浏览器。
arhtml = $.ajax({
url: "some.php",
async: false
}).responseText;
示例:
将一个XML文档作为数据发送到服务器。通过将processData选项设置为false,可以避免把自动把数据转换为字符串。
arxmlDocument = [create xml document];
$.ajax({
url: "page.php",
processData: false,
data: xmlDocument,
success: handleResponse
});
示例:
传入多个参数
var adu=$.ajax({
type: "POST",
url: "doAuditing",
data: "llId="+llId+"&llYorN="+llYorN,
async :false,
dataType:'html',
success: function(msg){
}
});
var num=adu.responseText;
if(num =="0"){
alert("修改失败,请刷新当前页面");
}else{
_search();
}