jQuery ajax() 方法
示例
使用 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 请求的一个或多个名称/值对。
下表中的可能名称/值
名称 | 值/描述 |
---|---|
async | 一个布尔值,指示请求是应异步处理还是同步处理。默认为 true |
beforeSend(xhr) | 在发送请求之前运行的函数 |
cache | 一个布尔值,指示浏览器是否应缓存请求的页面。默认为 true |
complete(xhr,status) | 请求完成时运行的函数(在 success 和 error 函数之后) |
contentType | 将数据发送到服务器时使用的内容类型。默认为:“application/x-www-form-urlencoded” |
context | 为所有 AJAX 回调函数指定“this”值 |
data | 指定要发送到服务器的数据 |
dataFilter(data,type) | 用于处理 XMLHttpRequest 的原始响应数据的函数 |
dataType | 服务器响应期望的数据类型。 |
error(xhr,status,error) | 如果请求失败,则运行的函数。 |
global | 一个布尔值,指定是否为请求触发全局 AJAX 事件处理程序。默认为 true |
ifModified | 一个布尔值,指定请求是否仅在上次请求后响应已更改时才成功。默认为:false。 |
jsonp | 一个字符串,用于覆盖 jsonp 请求中的回调函数 |
jsonpCallback | 为 jsonp 请求中的回调函数指定名称 |
password | 指定用于 HTTP 访问身份验证请求的密码。 |
processData | 一个布尔值,指定发送到请求的数据是否应转换为查询字符串。默认为 true |
scriptCharset | 指定请求的字符集 |
success(result,status,xhr) | 请求成功时运行的函数 |
timeout | 请求的本地超时(以毫秒为单位) |
traditional | 一个布尔值,指定是否使用参数序列化的传统样式 |
type | 指定请求类型。(GET 或 POST) |
url | 指定发送请求的 URL。默认为当前页面 |
username | 指定用于 HTTP 访问身份验证请求的用户名 |
xhr | 用于创建 XMLHttpRequest 对象的函数 |
亲手尝试 - 示例
使用 async 设置
如何使用 async 设置指定同步请求
使用指定的数据类型发出 AJAX 请求
如何使用 dataType 设置为请求指定数据类型。
发出带有错误的 AJAX 请求
如何使用 error 设置来处理 AJAX 请求中的错误。