jQuery入门笔记之（五）jQuery中的Ajax

发表于2016-01-03更新于2020-03-12字数统计3.4k阅读时长22分

关于Ajax的概述就不说了，有兴趣自己去找一下吧，并且建议去我博客看关于原生js实现Ajax函数的实现，希望有所帮助。服务器的配置，那篇文章也给出了地址。
Ajax入门（一）从0开始到一次成功的GET请求
Ajax入门（二）Ajax函数封装

jQuery中的Ajax

jQuery 对 Ajax 做了大量的封装，我们使用起来也较为方便，不需要去考虑浏览器兼容性。对于封装的方式，jQuery采用了三层封装：最底层的封装方法为：$.ajax()，而通过这层封装了第二层有三种方法：.load()、$.get()和$.post()，最高层是$.getScript()和$.getJSON()方法。

Ajax中的load()方法

1
2
3
4
5
6
7
8
9
10
/**
 * Ajax中的load方法（局部方法，可以直接绑定在需要获取的元素上）
 * @param {String}        url  必须，获取文件地址
 * @param {JSON or String}          可选，键值对方式的请求参数或者（使用键值对形式，请求将转化成post）
 * @param {Function}      可选，请求成功的回调函数
 *   @config   {String}   responseText         获得字符串形式的响应数据
 *   @config   {String}   textStatus            文本方式返回HTTP状态码
 *   @config   {Object}   XMLHttpRequest        xhr对象，有多种属性
 */
.load(url, data, complete(responseText, textStatus, XMLHttpRequest));

例如下面这段代码

1
2
3
$('button').click(function () {
    $('#box').load('test.php', {url : 'guowen'});
});

在控制台可以看到请求为POST，（注意：这里第二个参数若是字符串的情况，例如”url=guowen”，请求仍然为GET。）
所以服务器端php文件应该如此设置：

1
2
3
4
5
6
7
<?php
if ($_POST["url"] == "guowen") {//get请求把POST更改一下就好了
    echo "<a href='//guowenfh.github.io/'>三省吾身丶丶</a>";
} else {
    echo "其他网站";
}
?>

关于XHR对象上的属性，和HTTP状态码，参考我原来的博客。

$.get()和$.post()

.load()方法是局部方法，因为他需要一个包含元素的 jQuery 对象作为前缀。而$.get()和$.post()是全局方法，无须指定某个元素。对于用途而言，.load()适合做静态文件的异步获取，而对于需要传递参数到服务器页面的，$.get()和$.post()更加合适。

$.get()方法有四个参数，前面三个参数和.load()一样，多了一个第四参数type，即服务器返回的内容格式：包括xml、html、script、json、jsonp和text。第一个参数为必选参数，后面三个为可选参数

GET方式请求会直接在html后以?Key=value跟随，所以，有三种形式请求数据，

  1. 直接跟在url后
  2. 字符串形式的"url=guowen"
  3. 键值对形式的{url:"guowen"}

POST请求方式除去不能直接跟在url后之外，剩余两个，使用方法一样

注意: 与.load()方法不同的是：.load()方法根据第二个参数的不同类型，请求方式会改变，但这里已经是两个独立的方法了，所以请求类型不会进行转换。

第四个参数一般都不进行设置，jQuery会自动转换其类型。强制设置时，有可能会连标签一起返回。

至于POST与GET方式请求的差别，在我原来的博客中也有写到，这里就不赘述了。

$.getScript()和$.getJSON()

jQuery提供了一组用于特定异步加载的方法：$.getScript()，用于加载特定的JS文件；$.getJSON()，用于专门加载JSON文件。

$.getJSON()方法与之前的使用方法类似，就是把第四个参数，类型强制设置成了JSON。

有时我们希望能够特定的情况再加载JS文件，而不是一开始把所有JS文件都加载了，这时就可以使用$.getScript()方法。

1
2
3
4
//点击按钮后再加载 JS 文件
$('input').click(function () {
    $.getScript('test.js');
});

$.ajax()

$.ajax()是所有 ajax 方法中最底层的方法，所有其他方法都是基于$.ajax()方法的封装。这个方法只有一个参数，传递一个各个功能键值对的对象。

参数很多有兴趣的自己去看jQuery.ajax()，本来准备写几个常用的。强迫症犯了，去网上找资料做成了表格。。如下：

参数 类型 说明
url String 发送请求的地址
type String 请求方式：POST 或 GET，默认 GET
timeout Number 设置请求超时的时间（毫秒）
data Object 或String 发送到服务器的数据，键值对字符串或对象
dataType String 返回的数据类型，比如 html、xml、json 等
beforeSend Function 发送请求前可修改 XMLHttpRequest 对象的函数
complete Function 请求完成后调用的回调函数
success Function 请求成功后调用的回调函数
error Function 请求失败时调用的回调函数
global Boolean 默认为 true，表示是否触发全局 Ajax
cache Boolean 设置浏览器缓存响应，默认为 true。如果 dataType类型为 script 或 jsonp 则为 false。
content DOM 指定某个元素为与这个请求相关的所有回调函数的上下文。
contentType String 指 定 请 求 内 容 的 类 型 。 默 认 为application/x-www-form-urlencoded。
async Boolean 是否异步处理。默认为 true，false 为同步处理
processData Boolean 默认为 true，数据被处理为 URL 编码格式。如果为 false，则阻止将传入的数据处理为 URL 编码的格式。
dataFilter Function 用来筛选响应数据的回调函数。
ifModified Boolean 默认为 false，不进行头检测。如果为true，进行头检测，当相应内容与上次请求改变时，请求被认为是成功的。
jsonp String 指定一个查询参数名称来覆盖默认的 jsonp 回调参数名 callback。
username String 在 HTTP 认证请求中使用的用户名
password String 在 HTTP 认证请求中使用的密码
scriptCharset String 当远程和本地内容使用不同的字符集时，用来设置 script 和 jsonp 请求所使用的字符集。
xhr Function 用来提供 XHR 实例自定义实现的回调函数
traditional Boolean 默认为 false，不使用传统风格的参数序列化。如为 true，则使用

最常用的如下：

1
2
3
4
5
6
7
8
9
10
11
12
$('button').click(function () {
    $.ajax({
        type : 'POST', //这里可以换成 GET
        url : 'test.php',
        data : {
            url : 'guowen'
        },
        success : function (response, stutas, xhr) {
            $('#box').html(response);
        }
    });
});

注意：对于data属性，如果是GET、模式，可以使用三种之前说所的三种形式。如果是POST模式可以使用之前所说的两种形式。（这里不需要考虑之前的data类型的问题了，因为指定了请求类型，不会转化）

表单序列化

使用表单序列化方法.serialize()，会智能的获取指定表单内的所有元素。这样，在面对大量表单元素时，会把表单元素内容序列化为字符串，然后再使用Ajax请求。
序列化表单内的元素：data : $('form').serialize()，其余部分相同。

除此之外还可以直接获取单选框、复选框和下拉列表框等内容

除了.serialize()方法，还有一个可以返回 JSON 数据的方法：.serializeArray()。这个方法可以直接把数据整合成键值对的 JSON 对象。
使用方法相同$('form').serializeArray().

有时，我们可能会在同一个程序中多次调用$.ajax()方法。而它们很多参数都相同，这
个时候我们课时使用 jQuery 提供的$.ajaxSetup()请求默认值来初始化参数。

1
2
3
4
5
6
7
8
9
10
11
12
$('form input[type=button]').click(function () {
    $.ajaxSetup({//初始化多个ajax方法相同部分参数，后面再写ajax的时候，就不用在写了。
        type : 'POST',
        url : 'test.php',
        data : $('form').serialize()//表单序列化
    });
    $.ajax({
        success : function (response, status, xhr) {
                    alert(response);
                }
    });
});

在使用 data 属性传递的时候，如果是以对象形式传递键值对，可以使用$.param()方法将对象转换为字符串键值对格式。

主要是针对无法直接使用表单序列化方法.serialize()的情况，且传递参数为对象，建议使用该方法进行解析后再进行传递。

Ajax进阶

加载请求，及错误处理。

主要是处理网速较慢的情况，出现请求时间较长的问题。而此时若没有一点提示，用户可能会认为你的网页出现了问题。若是能在请求过程中给用户一些提示，比如：正在努力加载中…… 。 可能会对用户更加友好一些。
jQuery提供了两个全局事件，jQuery 提供了两个全局事件，.ajaxStart()和.ajaxStop()。
这两个全局事件，只要用户触发了 Ajax，请求开始时（未完成其他请求）激活.ajaxStart()，请求结束时（所有请求都结束了）激活.ajaxStop()。
值得注意的是，因为是全局事件，所以这两个方法是直接需要直接绑定到document上的。例如：

1
2
3
4
5
$(document).ajaxStart(function(){
    $(".loading").show();
}).ajaxStop(function(){
    $(".loading").hide();
});

当然你也可以自行在ajax内部进行一些设置,如请求超时时间，该ajax函数是否触发全局事件等等。以键值对的方式写明就可以了。

错误处理也特别简单

1
2
3
4
5
6
7
8
$.ajax({
    //…………
    timeout : 500,//如果请求时间太长，可以设置超时
    global : false,//如果某个 ajax 不想触发全局事件，可以设置取消
    error : function(xhr,errorText,errorType){//一般都直接用xhr对象
                alert("发生错误："+xhr.status);//返回错误状态码
            }
});

除此之外$.get()、$.post()和.load(),可以通过连缀处理使用局部.error()方法来处理错误，当然还有一个全局的方法：通过全局.ajaxError()事件方法来返回错误信息。即可

请求全局事件

jQuery 对于 Ajax 操作提供了很多全局事件方法，除去上面已经提到的.ajaxStart()、.ajaxStop()、.ajaxError()等事件方法。他们都属于请求时触发的全局事件，除了这些，还有一些其他全局事件：

  1. .ajaxSuccess()，对应一个局部方法：.success()，请求成功完成时执行。
  2. .ajaxComplete()，对应一个局部方法：.complete()，请求完成后注册一个回调函数。
  3. .ajaxSend()，没有对应的局部方法，只有属性 beforeSend，请求发送之前要绑定的函数。

注意：全局事件方法是所有 Ajax 请求都会触发到，并且只能绑定在 document 上。而局部方法，则针对某个 Ajax。
对于一些全局事件方法的参数，大部分为对象，而这些对象有哪些属性或方法能调用，
可以通过遍历方法得到。如：

1
2
3
4
5
6
//遍历 settings 对象的属性
$(document).ajaxSuccess(function (event, xhr, settings) {
    for (var i in settings) {
        console.log(i);
    }
});

这些全局方法，在$.ajax()方法中都可以直接以参数中的键值对的形式来完成

JSON和JSONP

其实在同一个域中时，只要url的后缀是json的文件的，默认就是json。当然你还可以使用$.ajax()方法设置 dataType属性加载 JSON 文件。

先来试试本地JSON:
php如下：

1
2
3
4
5
<?php
    $_arr= array('a'=>1,'b'=>2,'c'=>3);
    $_result = json_encode($_arr);
    echo $_result;
?>

js:

1
2
3
4
5
6
7
8
$.ajax({
    type:"post",
    url:"test.php",
    dataType:"json",//因为文件类型是php。但是返回的数据是json，所以必须设置类型，否则返回字符串
    success:function(response,staus,xhr){
        console.log(response.a);//打印出来1
    }
});

实现跨域：这部分需要服务器端配合。

1
2
3
4
5
6
<?php
    $_arr= array('a'=>1,'b'=>2,'c'=>3);
    $_result = json_encode($_arr);
    $_callback = $_GET['callback'];//关键在这。配合客户端JS使用
    echo $_callback."($_result)";//php用点号实现字符串拼接
?>

客户端实现：

1
2
3
4
5
6
7
8
9
$.ajax({//我本地地址为http://127.0.0.1:8020/ajax.html
    type:"GET",
    url:"http://localhost/test.php?callback=?",//这样就可以实现跨域资源的访问了，最后的？号，jQuery会自动转化成字符串
    dataType:"json",//若这里使用JSONP的话，可以删除上面url的“?callback=?”，jQuery会自动处理。
    success:function(response,staus,xhr){
        alert(response.a);
        console.log(response)
    }
});

当然我们还可以进行使用$.getJSON()。使用方式同上。

jqXHR对象

在之前，我们使用了局部方法：.success()、.complete()和.error()。这三个局部方法并不是 XMLHttpRequest 对象调用的，而是$.ajax()之类的全局方法返回的对象调用的。这个对象，就是 jqXHR 对象，它是原生对象 XHR 的一个超集。

1
2
3
4
5
6
7
8
9
//获取 jqXHR 对象，查看属性和方法
var jqXHR = $.ajax({
    type : 'POST',
    url : 'test.php',
    data : $('form').serialize()
});
for (var i in jqXHR) {
    document.write(i + '<br />');
}

注意：如果使用 jqXHR 对象的话，那么建议用.done()、.always()和.fail()代
替.success()、.complete()和.error()。以为在未来版本中，很可能将这三种方法废弃取消。

1
2
3
4
//成功后回调函数
jqXHR.done(function (response) {
    $('#box').html(response);
});

使用 jqXHR 的连缀方式比$.ajax()的属性方式有三大好处：

  1. 可连缀操作，可读性大大提高；
  2. 可以多次执行同一个回调函数；
  3. 为多个操作指定回调函数；

PS：很多都只做了一下测试，并不能熟练应用，先过一遍吧，以后再来熟练掌握。

使用搜索：谷歌必应百度