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 请求中的错误。