有关jQuery.getJSON() 函数的用法详解
JSON是一种数据格式,JS原生支持JSON格式,通过jQuery.getJSON()从服务器获得的JSON数据,jQuery会先尝试将其转为对应的JS对象。
如果请求的URL中包括"callback=?"等类似的部分,jQuery会自动将其视作JSONP,并执行对应的回调函数来获取JSON数据。
重要注意:服务器返回的JSON数据必须符合严格的JSON语法,例如:所有属性名称必须加双引号,所有字符串值也必须加双引号(而不是单引号)。
请注意,该函数是通过异步方式加载数据的。
该函数属于全局jQuery对象。
语法
jQuery 1.0 新增该静态函数。
jQuery.getJSON( url [, data ] [, success ] )
参数
参数 描述
url String类型指定请求的目标URL。
data 可选/String/Object类型发送请求传递的数据。
success 可选/Function类型请求成功时执行的回调函数。它有3个参数:其一是请求返回的数据,其二是请求状态文本(例如"success"、 "notmodified"),其三是当前jqXHR对象(jQuery 1.4及之前版本,该参数为原生的XMLHttpRequest对象)。
参数success指定的回调函数只有在请求成功时才会执行,如果请求失败(例如找不到页面、服务器错误等)则不作任何处理。
返回值
jQuery.getJSON()函数的返回值为jqXHR类型,返回发送该请求的jqXHR对象(jQuery 1.4及以前版本返回的是原生的XMLHttpRequest对象)。
示例&说明
jQuery.getJSON()是jQuery.ajax()函数的如下简写形式:
jQuery.getJSON(url, data, success); // 等价于 $.ajax({ url: url, type: "GET", data: data, success: success, dataType: "json" });
请参考以下这段HTML示例代码:
<div id="content1">CodePlayer</div> <div id="content2">专注于编程开发技术分享</div> <div id="content3">http://www.365mini.com</div>
以下是与jQuery.getJSON()函数相关的jQuery示例代码,以演示jQuery.getJSON()函数的具体用法:
//获取index.php?type=json的JSON数据,但不作任何处理 $.getJSON( "index.php?type=json" ); // 等价于 index.php?id=5&orderId=5&money=100 $.getJSON( "index.php?id=5", "orderId=5&money=100" ); // 等价于 http://localhost/index.php?id=5&orderId=5&money=100 $.getJSON( "http://localhost/index.php?id=5", {orderId: 5, money: 100} ); /* ***** 一般不会使用上述不对获取的JSON数据作任何处理的用法***** */ // 获取index.php?type=json的JSON数据,获取成功时弹出对话框 $.getJSON( "index.php?type=json", function(data, textStatus, jqXHR){ // data 是该请求返回的数据(可能经过处理) // textStatus 可能是"success"、 "notmodified"等 // jqXHR 是经过jQuery封装的XMLHttpRequest对象(保留其本身的所有属性和方法) // 如果服务器返回的JSON格式的数据是 {"id": 5, "name": "CodePlayer"} // JSON格式的数据的属性名称必须加双引号,字符串值必须加双引号。 // jQuery已经将其转换成对应的JS对象 alert( data.id ); // 5 alert( data.name ); // CodePlayer } ); // 获取"/action.php?m=list&page=2&size=10"的JSON数据,获取成功时弹出对话框 $.getJSON( "/action.php?m=list", { page: 2, size: 10 }, function(data, textStatus, jqXHR){ // 如果服务器返回的JSON格式的数据是 [ {"id":11, "title":"文章11"}, {"id":12, "title":"文章12"}, {"id":13, "title":"文章13"} ] // jQuery将获取的JSON格式数据转换为JS数组 for(var i in data){ var obj = data[i]; alert( obj.title ); } } );
以上就是有关jQuery.getJSON() 函数的用法详解的详细内容,更多请关注其它相关文章!
上一篇: ajax常用的函数
下一篇: js中函数的三种定义方式