jQuery对Ajax做了大量的封装，jQuery采用了三层封装： 最底层的封装方法为：$.ajax() 通过最底层进一步封装了第二层的三种方法：.load()、$.get()、$.post() 最高层是：$.getScript() and $.getJSON()
我自己的记忆方法：$.ajax()是异步处理本源，它是一个区域、一个村子、一个小型生态系统，是jQuery的一个分公司；$.get()是得到、获得，也就是往我们的生态系统中运输我们生态系统所没有的东西；$.post()是把我们不能完全消耗的物品运出去换我们需要的东西；一个掌管输入，一个掌管输出，这时就需要一个管理自身的管家，而.load()就是管理生态系统的管家，由于它不需要出去，只是在自家进行活动，所以就不用打上，jQuery公司的LOGO=>$了。由于我们有的货物是重要的有的是次要的，这样就诞生了贵宾服务，$.getScript()和$.getJSON()这两个专为贵宾服务的特殊通道，方便快捷
【1】.laod()方法拥有三个参数： 1. url：必须，请求html文件的url地址，参数类型为String 2. data：可选，发送的key/value数据，参数类型为Object 3. callback：可选，成功或失败的回调函数，参数类型为函数Function
// 例子：
GET方式：不传递data,则默认get方式
$('.ajax_btn').on('click',function(){
$('.ajax_box').load('ajax.php?url=snail',function(){
alert('我是回调函数！');
});
});
<?php
if($_GET['url']=='snail'){
echo '蜗牛';
}else{
echo '其它动物！';
}
?>
// POST方式：传递data,则为post方式
$('.ajax_btn').on('click',function(){
$('.ajax_box').load('ajax.php',{
url:'snail',
},function(){
alert('我是回调函数！');
});
});
<?php
if($_POST['url']=='snail'){
echo '蜗牛';
}else{
echo '其它动物！';
}
?>
在Ajax数据载入完毕之后，就能执行回调函数callback，也就是第三个参数； 回调函数可以传递三个可选参数：responseText(请求返回)、textStatus(请求状态)、XMLHttpRequest(XMLHttpRequest对象)
$('.ajax_btn').on('click',function(){
$('.ajax_box').load('ajax.php',{
url:'snail',
},function(response,status,xhr){
console.log('返回的值为：'+response+'，状态为：'+status+'，状态是：'+xhr.statusText);
// 返回的值为：蜗牛，状态为：success，状态是：OK
console.log('返回的值为：'+xhr.responseText+'，XML DOM文档：'+xhr.responseXML+'，响应的HTTP状态：'+xhr.status+'，HTTP状态的说明：'+xhr.statusText);
// index.html:36 返回的值为：蜗牛，XML DOM文档：undefined，响应的HTTP状态：200，HTTP状态的说明：OK
});
});
<?php
if($_POST['url']=='snail'){
echo '蜗牛';
}else{
echo '其它动物！';
}
?>
注意：status得到的值，如果成功返回数据则为：success，否则为：error。XMLHttpRequest对象属于JavaScript范涛，可以调用一些属性如下：
属性名 说明 responseText 作为响应主体被返回的文本 responseXML 如果响应主体内容类型是"text/xml"或"application/xml"，则返回包含响应数据的XML DOM文档 status 响应的HTTP状态 statusText HTTP状态的说明
返回数据status和statusText对照表： HTTP状态码 状态字符串 说明 200 OK 服务器成功返回了页面 400 Bad Request 语法错误导致服务器不识别 401 Unauthorized 请求需要用户认证 404 Not found 指定的 URL 在服务器上找不到 500 Internal Server Error 服务器遇到意外错误,无法完成请求 503 ServiceUnavailable 由于服务器过载或维护导致无法完成请求
【2】$.get()和$.post() .load()方法是局部方法，因为它需要一个包含元素的jQuery对象作为前缀。 而$.get()和$.post()是全局方法，无须指定某个元素。 用途方面：.load()适合做静态文件的异步获取，而对于需要传递参数到服务器页面的，$.get()和$.post()更加合适
$.get()方法有四个参数：前面三个和.load()一样，多了一个第四参数type，即服务器返回的内容格式： 包括xml、html、script、json、jsonp和text 第一个参数为必选参数，后面三个为可选参数
$('.ajax_btn').on('click',function(){
$.get('ajax.php',{
url:'snail',
},function(response,status,xhr){
if(status=='success'){
$('.ajax_box').html(response);
}
// type自动转化成text
})
});
注意:第四参数type是指定异步返回的类型。一般情况下type参数是智能判断,并不需要我们主动设置,如果主动设置,则会强行按照指定类型格式返回。
$('.ajax_btn').on('click',function(){
$.get('ajax.xml',{
url:'snail',
},function(response,status,xhr){
if(status=='success'){
$('.ajax_box').html(response);
}
// type自动转化成XML
})
});
注意:如果载入的是xml文件,type会智能判断。如果强行设置html类型返回,则会把xml文件当成普通数据全部返回,而不会按照xml格式解析数据。
$.post()方法的使用和$.get()基本上一致,他们之间的区别也比较隐晦,基本都是背后的不同,在用户使用上体现不出。 具体区别如下: 1.GET请求是通过URL提交的,而POST请求则是HTTP消息实体提交的; 2.GET提交有大小限制(2KB),而POST方式不受限制; 3.GET方式会被缓存下来,可能有安全性问题,而POST没有这个问题; 4.GET方式通过$_GET[]获取,POST方式通过$_POST[]获取。
$('.ajax_btn').on('click',function(){
$.post('ajax.php',{
url:'snail',
},function(response,status,xhr){
if(status=='success'){
$('.ajax_box').html(response);
}
})
});
$.getScript()和$.getJSON()=> jQuery提供了一组用于特定异步加载的方法: $.getScript(),用于加载特定的JS文件; $.getJSON(),用于专门加载JSON文件。
$('.ajax_btn').on('click',function(){
$.getScript('ajax.js');
});
$('.ajax_btn').on('click',function(){
$.getJSON('ajax.json',function(response,status,xhr){
console.log(response.ajax.name);
});
});
$.ajax()是所有ajax方法中最底层的方法,所有其他方法都是基于$.ajax()方法的封装。
这个方法只有一个参数,传递一个各个功能键值对的对象。
$.ajax()方法对象参数表:
参数 类型 说明 url String 发送请求的地址 type String 请求方式:POST或GET,默认GET timeout Number 设置请求超时的时间(毫秒) data Object或String 发送到服务器的数据,对象或键值对字符串 dataType String 返回的数据类型,比如html、xml、json等 beforeSend Function 发送请求前可修改XMLHttpRequest对象的函数 complete Function 请求完成后调用的回调函数 seccess 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,则使用。
$('.ajax_btn').on('click',function(){
$.ajax({
type:"GET",
url:"ajax.php",
data:{
url:"snail",
},
success:function(response,status,xhr){
console.log(response);
}
})
});
注意:对于data属性,如果是GET模式,可以使用三种之前说所的三种形式。如果是POST模式可以使用之前的两种形式。
一.加载请求 在Ajax异步发送请求时,遇到网速较慢的情况,就会出现请求时间较长的问题。而超过一定时间的请求,用户就会变得不再耐烦而关闭页面。而如果在请求期间能给用户一些提示,比如:正在努力加载中...,那么相同的请求时间会让用户体验更加的好一些。
Query提供了两个全局事件,.ajaxStart()和.ajaxStop()。 这两个全局事件,只要用户触发了Ajax,请求开始时(未完成其他请求)激活.ajaxStart(),请求结束时(所有请求都结束了)激活.ajaxStop()。
$('.ajax_load').ajaxStart(function(){
$(this).show();
}).ajaxStop(function(){
$(this).hide();
});
注意:以上代码在jQuery1.8及以后的版本不在有效,需要使用jquery-migrate向下兼容才能运行。新版本中,必须绑定在document元素上。
$(document).ajaxStart(function(){
$('.ajax_load').show();
}).ajaxStop(function(){
$('.ajax_load').hide();
});
// 请求时间过长，导致页面呈现假死状态，所以可以设置超时
$.ajax({
timeout:2000,
});
// 如果某个ajax不想触发全局事件,可以设置取消;比如取消触发.ajaxStart()和.ajaxStop()全局事件：
$.ajax({
global:false,
});
二.错误处理
Ajax异步提交时,不可能所有情况都是成功完成的,也有因为代码异步文件错误、网络错误导致提交失败的。这时,我们应该把错误报告出来,提醒用户重新提交或提示开发者进行修补。
在之前高层封装中是没有回调错误处理的,比如$.get()、$.post()和.load()。所以,早期的方法通过全局.ajaxError()事件方法来返回错误信息。而在jQuery1.5之后,可以通过连缀处理使用局部.error()方法即可。而对于$.ajax()方法,不但可以用这两种方法,还有自己的属性方法error:function(){}。
$('.ajax_btn').on('click',function(){
$.ajax({
type:"GET",
url:"ajax.php",
data:{
url:"snail",
},
success:function(response,status,xhr){
console.log(response);
},
error:function(xhr,errorText,errorStatus){
console.log(xhr);
console.log(errorText);
console.log(errorStatus);
}
})
});
// $.post()使用连缀.error()方法提示错误,连缀方法将被.fail()取代
$.post('ajax.php').error(function(xhr,status,info){
console.log(xhr.status+':'+xhr.statusText);
console.log(status+':'+info);
});
// $.post()使用全局.ajaxError()事件提示错误
$(document).ajaxError(function(event,xhr,settings,infoError){
alert(xhr.status+':'+xhr.statusText);
alert(settings+':'+info);
});
三.请求全局事件 jQuery对于Ajax操作提供了很多全局事件方法,.ajaxStart()、.ajaxStop()、.ajaxError()等事件方法。他们都属于请求时触发的全局事件,除了这些,还有一些其他全局事件: .ajaxSend(),没有对应的局部方法,只有属性beforeSend,请求发送之前要绑定的函数。 .ajaxComplete(),对应一个局部方法:.complete(),请求完成后注册一个回调函数。 .ajaxSuccess(),对应一个局部方法:.success(),请求成功完成时执行。 注意:全局事件方法是所有Ajax请求都会触发到,并且只能绑定在document上。而局部方法,则针对某个Ajax。对于一些全局事件方法的参数,大部分为对象,而这些对象有哪些属性或方法能调用,可以通过遍历方法得到。
// 遍历settings对象的属性
$(document).ajaxSuccess(function(event,xhr,settings){
for(var i in settings){
console.log(i);
}
});
// $.post()请求完成的局部方法.complete()
$.post().complete(function(xhr,status){
console.log("完成！");
})
// $.post()请求完成的全局方法.ajaxComplete()
$(document).ajaxComplete(function(event,xhr,setting){
console.log("完成！");
})
// $.ajax()方法,可以直接通过属性设置即可。
$.ajax({
type:"POST",
url:"ajax.php",
success:function(data,status,xhr){},
complete:function(xhr,status){},
beforeSend:function(xhr,settints){}
})
注意:在jQuery1.5版本以后,使用.success()、.error()和.complete()连缀的方法,可以用.done()、.fail()和.always()取代。
四.JSON和JSONP 如果在同一个域下,$.ajax()方法只要设置dataType属性即可加载JSON文件。而在非同域下,可以使用JSONP,但也是有条件的。 如果想跨域操作文件的话,我们就必须使用JSONP。JSONP(JSON with Padding)是一个非官方的协议,它允许在服务器端集成Script tags返回至客户端,通过javascriptcallback的形式实现跨域访问(这仅仅是JSONP简单的实现形式)。
$.ajax({
type:"GET",
dataType:"jsonp",
success:function(data,status,xhr){}
})
五.jqXHR对象 在之前,我们使用了局部方法:.success()、.complete()和.error()。这三个局部方法并不是XMLHttpRequest对象调用的,而是$.ajax()之类的全局方法返回的对象调用的。这个对象,就是jqXHR对象,它是原生对象XHR的一个超集。 注意:如果使用jqXHR对象的话,那么建议用.done()、.always()和.fail()代 替.success()、.complete()和.error()。以为在未来版本中,很可能将这三种方法废弃取消。 使用jqXHR的连缀方式比$.ajax()的属性方式有三大好处: 1.可连缀操作,可读性大大提高; 2.可以多次执行同一个回调函数; 3.为多个操作指定回调函数;