jQuery ajax() 方法
jQuery 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 对象的函数 |
范例
使用 AJAX 请求改变 <div> 元素的文本
$("button").click(function(){ $.ajax({url:"/static/media/jquery/demo_test.txt",success:function(result){ $("#div1").html(result); }}); });
更多范例
-
如何使用异步设置来规定异步请求
-
如何使用 dataType 设置来规定请求的数据类型
-
如何使用错误设置来处理 AJAX 请求中的错误。