内容目录
jQuery.get()
函数用于通过HTTP GET形式的AJAX请求获取远程数据。
jQuery.get()
函数用于实现简单的GET形式的AJAX请求,它在底层是使用jQuery.ajax()来实现的,只是省略了大多数不常用的参数设置,并仅限于HTTP GET方式。
请注意,该函数是通过异步方式加载数据的。
这里介绍的jQuery.get()
是一个全局方法(无需创建jQuery对象即可调用,你可以理解为静态函数)。jQuery中还有一个同名的实例方法get(),用于获取当前jQuery对象中匹配的指定索引的DOM元素。
该函数属于全局jQuery
对象。
语法
jQuery 1.0 新增该静态函数。
jQuery.get( url [, data ] [, success ] [, type ] )
参数
参数 | 描述 |
---|---|
url | String类型指定请求的目标URL。 |
data | 可选/String/Object类型发送请求传递的数据。 |
success | 可选/Function类型请求成功时执行的回调函数。它有3个参数:其一是请求返回的数据,其二是请求状态文本(例如"success"、 "notmodified"),其三是当前jqXHR对象(在jQuery 1.4及之前版本中,该参数为原生的XMLHttpRequest对象)。 |
type | 可选/String类型指定请求返回的数据类型,可以为xml、 html、 script、 json、 jsonp、text。如果省略该参数,jQuery将会根据请求进行智能猜测,猜测范围为:xml、 json、 script 或html。 |
关于参数type
的值所表示的含义,请参考jQuery.ajax()中的可选参数dataType。
参数success
指定的回调函数只有在请求成功时才会执行,如果请求失败(例如找不到页面、服务器错误等)则不作任何处理。
返回值
jQuery.get()
函数的返回值为jqXHR类型,返回发送该请求的jqXHR对象(在jQuery 1.4及之前版本中,返回的是原生的XMLHttpRequest对象)。
jqXHR
对象是经过jQuery封装的类XMLHttpRequest对象。
示例&说明
jQuery.get()
是jQuery.ajax()
函数的如下简写形式:
jQuery.get(url, data, success, dataType);
// 等价于
$.ajax({
url: url,
type: "GET",
data: data,
success: success,
dataType: dataType
});
请参考以下这段HTML示例代码:
<div id="content1">CodePlayer</div>
<div id="content2">专注于编程开发技术分享</div>
<div id="content3">https://codeplayer.vip</div>
以下是与jQuery.get()
函数相关的jQuery示例代码,以演示jQuery.get()
函数的具体用法:
// 以GET请求方式获取http://localhost/index.php?id=5的数据,但不作任何处理
$.get( "http://localhost/index.php?id=5" );
// 等价于 http://localhost/index.php?id=5&orderId=5&money=100
$.get( "http://localhost/index.php?id=5", "orderId=5&money=100" );
// 等价于 http://localhost/index.php?id=5&orderId=5&money=100
$.get( "http://localhost/index.php?id=5", {orderId: 5, money: 100} );
/* ***** 一般不会使用上述不对获取的数据作任何处理的用法***** */
// 以GET请求方式获取http://localhost/index.php?id=5的数据,将返回的html内容追加到body标签内
$.get( "http://localhost/index.php?id=5", function(data, textStatus, jqXHR){
// data 是该请求返回的数据(可能经过处理)
// textStatus 可能是"success"、 "notmodified"等
// jqXHR 是经过jQuery封装的XMLHttpRequest对象(保留其本身的所有属性和方法)
$("body").append( data );
} );
$.get( "http://localhost/index.php?id=5", { bookId: 2 }, function(data, textStatus, jqXHR){
// 如果返回的原始文本数据为{ "name": "CodePlayer", "age": 20 }
// 由于get()指定了返回数据的类型为JSON,则jQuery将会尝试将返回数据转换为JSON对象
// 如果转换成功,这里的data就已经是一个js对象
alert( data.name ); // CodePlayer
}, "json" );
0 条评论
撰写评论