jQuery ajax() 方法
实例
使用 AJAX 请求更改 <div >元素的文本:
<!DOCTYPE html>
<html>
<head>
<script src="https://libs.baidu.com/jquery/2.1.4/jquery.min.js"></script>
<script>
$(document).ready(function(){
$("button").click(function(){
$.ajax({url: "/example/ajax/demo.txt", success: function(result){
$("#div1").html(result);
}});
});
});
</script>
</head>
<body>
<div id="div1"><h2>让 jQuery AJAX 更改此文本</h2></div>
<button>获取外部内容</button>
</body>
</html>
定义与用法
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 对象的函数 |
更多实例
如何使用异步设置指定同步请求
如何使用数据类型设置为请求指定数据类型。
如何使用 error 设置来处理 AJAX 请求中的错误。