jQuery ajax() 方法

实例

使用 AJAX 请求更改 <div >元素的文本:

  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4. <script src="https://libs.baidu.com/jquery/2.1.4/jquery.min.js"></script>
  5. <script>
  6. $(document).ready(function(){
  7. $("button").click(function(){
  8. $.ajax({url: "/example/ajax/demo.txt", success: function(result){
  9. $("#div1").html(result);
  10. }});
  11. });
  12. });
  13. </script>
  14. </head>
  15. <body>
  16. <div id="div1"><h2>让 jQuery AJAX 更改此文本</h2></div>
  17. <button>获取外部内容</button>
  18. </body>
  19. </html>

定义与用法

ajax() 方法用于执行 AJAX(异步 HTTP)请求。

所有 jQuery AJAX 方法都使用 ajax() 方法。此方法主要用于无法使用其他方法的请求。

语法

  1. $.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 设置 AJAX 请求

如何使用异步设置指定同步请求

使用指定的数据类型发出 AJAX 请求

如何使用数据类型设置为请求指定数据类型。

发出带有错误处理的 AJAX 请求

如何使用 error 设置来处理 AJAX 请求中的错误。

分类导航