jQuery的ajax详解
jQuery内部也封装了对原生ajax请求的方法,可以很方便我们的对后台异步请求处理。
$.get()方法
语法:jQuery.get( url [, data ] [, success ] [, dataType ] )
- url 请求的后台地址
- data 传递的参数
- success 成功的回调,
function(PlainObject data, String textStatus, jqXHR jqXHR )
- dataType 预期后台返回数据的类型,默认会自动智能判断(xml, json, script, text, html)
$.get('/user.json', function(data) {
console.log(data);
});
$.get('/user.json', 'id=1', function (data, status, jsXHR) {
console.log(data.id);
}, 'json');
$.post()方法
语法: jQuery.post( url [, data ] [, success ] [, dataType ] )
用法跟get基本一致。列子:
$.post('/api/user', {id: 3, name: 234}, function(data, status, jsXHR) {
console.log(data);
});
$.ajax()方法
语法1: jQuery.ajax( [settings ] )
settings 是一个普通的对象。可以有如下设置:
- async 类型:Boolean
默认值: true。默认设置下,所有请求均为异步请求。如果需要发送同步请求,请将此选项设置为 false。
注意,同步请求将锁住浏览器,用户其它操作必须等待请求完成才可以执行。
- beforeSend(XHR) 类型:Function
发送请求前可修改 XMLHttpRequest 对象的函数,如添加自定义 HTTP 头。
XMLHttpRequest 对象是唯一的参数。
这是一个 Ajax 事件。如果返回 false 可以取消本次 ajax 请求。
- cache 类型:Boolean
默认值: true,dataType 为 script 和 jsonp 时默认为 false。设置为 false 将不缓存此页面。
- contentType 类型:String
默认值: "application/x-www-form-urlencoded"。发送信息至服务器时内容编码类型。
- data 类型:String
发送到服务器的数据。将自动转换为请求字符串格式。GET 请求中将附加在 URL 后。查看 processData 选项说明以禁止此自动转换。必须为 Key/Value 格式。如果为数组,jQuery 将自动为不同值对应同一个名称。如 {foo:["bar1", "bar2"]} 转换为 '&foo=bar1&foo=bar2'。
-
dataType 类型:String
预期服务器返回的数据类型。 (xml、html、script、json、jsonp、text)。jq会将自动根据 HTTP 包 MIME 信息来智能判断,比如 XML MIME 类型就被识别为 XML。 -
error 类型:Function
默认值: 自动判断 (xml 或 html)。请求失败时调用此函数。
有以下三个参数:XMLHttpRequest 对象、错误信息、(可选)捕获的异常对象。
如果发生了错误,错误信息(第二个参数)除了得到 null 之外,还可能是 "timeout", "error", "notmodified" 和 "parsererror"。
- success 类型:Function
请求成功后的回调函数。
参数:由服务器返回,并根据 dataType 参数进行处理后的数据;描述状态的字符串。
这是一个 Ajax 事件。
- type 类型:String
默认值: "GET")。请求方式 ("POST" 或 "GET"), 默认为 "GET"。注意:其它 HTTP 请求方法,如 PUT 和 DELETE 也可以使用,但仅部分浏览器支持。
- url 类型:String
默认值: 当前页地址。发送请求的地址。
- jsonp 类型:String
在一个 jsonp 请求中重写回调函数的名字。这个值用来替代在 "callback=?" 这种 GET 或 POST 请求中 URL 参数里的 "callback" 部分,比如 {jsonp:'onJsonPLoad'} 会导致将 "onJsonPLoad=?" 传给服务器。
- jsonpCallback 类型:String
为 jsonp 请求指定一个回调函数名。这个值将用来取代 jQuery 自动生成的随机函数名。这主要用来让 jQuery 生成度独特的函数名,这样管理请求更容易,也能方便地提供回调函数和错误处理。你也可以在想让浏览器缓存 GET 请求的时候,指定这个回调函数名。
语法2:jQuery.ajax( url [, settings ] )
$.ajax({
url: 'user.json',
data: 'id=3',
type: 'GET',
success: function(data) {
console.log(data);
}
});
$.getJSON()
语法: jQuery.getJSON( url [, data ] [, success ] )
用法类似于get,但是返回的数据类型自动转换为json对象。
此方法,支持JSONP的调用。如果url中包含了callback=?
或者后台要求的callback参数,那么此方法自动转换成jsonp的调用模式。
$.getJSON('user.json', function(data) {
console.log(data.id);
});
jQuery.getScript()方法
执行后台的请求,并下载js脚本,下载完成后,自动执行。
语法: jQuery.getScript( url [, success ] )
$.getScript( "ajax/test.js", function( data, textStatus, jqxhr ) {
console.log( data ); // Data returned
console.log( textStatus ); // Success
console.log( jqxhr.status ); // 200
console.log( "Load was performed." );
});
load()方法
从后台下载html内容,下载完成后替换到选择元素的内部。
语法:$(selector).load( url [, data ] [, complete ] )
$('.box').load('/user/list', {}, function(data) {});