jQuery $.ajax() 方法



  • 定义和用法

    $.ajax() 方法用于执行 AJAX(异步 HTTP)请求。
    所有的 jQuery AJAX 方法都使用 $.ajax() 方法。该方法通常用于其他方法不能完成的请求。
  • 语法

    $.ajax({name:value, name:value, ... })
  • 参数

    该参数为带有一个或多个名称/值对的 AJAX 请求规定设置。
    名称 值类型 描述
    async Boolean 表示请求是否异步处理。默认是 true。
    beforeSend(xhr) Function 发送请求前运行的函数。
    cache Boolean 表示浏览器是否缓存被请求页面。默认是 true。
    complete(xhr,status) Function 请求完成时运行的函数(在请求成功或失败之后均调用,即在 success 和 error 函数之后)。
    contentType String 发送数据到服务器时所使用的内容类型。默认是:"application/x-www-form-urlencoded"。
    context String 为所有 AJAX 相关的回调函数规定 "this" 值。
    data Object 规定要发送到服务器的数据。
    dataFilter(data,type) Function 用于处理 XMLHttpRequest 原始响应数据的函数
    dataType String 预期的服务器响应的数据类型。
    error(xhr,status,error) Function 如果请求失败要运行的函数。
    global Boolean 规定是否为请求触发全局 AJAX 事件处理程序。默认是 true。
    ifModified Boolean 规定是否仅在最后一次请求以来响应发生改变时才请求成功。默认是 false。
    jsonp String 在一个 jsonp 中重写回调函数的字符串。
    jsonpCallback Function 在一个 jsonp 中规定回调函数的名称。
    password String 规定在 HTTP 访问认证请求中使用的密码。
    processData Boolean 规定通过请求发送的数据是否转换为查询字符串。默认是 true。
    scriptCharset String 规定请求的字符集。
    success(result,status,xhr) Function 当请求成功时运行的函数。
    timeout Number 设置本地的请求超时时间(以毫秒计)。
    traditional Boolean 规定是否使用参数序列化的传统样式。
    type String 规定请求的类型(GET 或 POST)。
    url String 规定发送请求的 URL。默认是当前页面。
    username String 规定在 HTTP 访问认证请求中使用的用户名。
    xhr Function 用于创建 XMLHttpRequest 对象的函数。
  • 实例

    下例演示了使用 AJAX 请求改变 <div> 元素的文本:
    <!DOCTYPE html>
    <html lang="en">
    <head>
    <meta charset="UTF-8">
    <title>欢迎来到蝴蝶教程</title>
    //此版本是百度cdn 1.11.1,当然你可以使用更高的版本,从2.0版本以上的是不支持ie6-8的
    <script type="text/javascript" src="http://libs.baidu.com/jquery/1.11.1/jquery.min.js"></script>
    <script>
        $(document).ready(function () {
            $("button").click(function(){
                $.ajax({
                    url:"/jc_script/jqAjax/demo_test.txt",
                    success:function(result){
                       $("#div1").html(result);
                    }
               });
            });
        });
    </script>
    </head>
    <body>
         <div id="div1">
             <h2>让jQuery AJAX更改此文本 </h2>
         </div>
         <button>获取外部内容</button>
    </body>
    </html>