前端拿到 JSON 之後怎麼取出資料?jQuery 提供了 $.getJSON() 負責抓、$.each() 負責遍歷,兩者搭起來就能應付絕大多數情境。以下用一組留言資料當例子,從最簡單的陣列一路談到巢狀結構與 map。
這是一段巢狀 JSON,comments 底下是一個物件陣列:
代碼如下:
{"comments":[{"content":"很不錯嘛","id":1,"nickname":"納尼"},{"content":"喲西喲西","id":2,"nickname":"小強"}]}
jQuery.getJSON( url [, data] [, success(data, textStatus, jqXHR)] )
三個參數分別是請求網址、要一併送出的資料(物件或字串),以及請求成功後執行的回呼。回呼會收到三個參數:回傳的資料、狀態字串、以及 jQuery 包裝過的 XMLHttpRequest 物件。日常使用只需要第一個。
jQuery.each( collection, callback(indexInArray, valueOfElement) )
第一個參數是要遍歷的陣列或物件,第二個是對每一項執行的函式;該函式又收到「目前索引」與「目前的值」兩個參數。有了它,解析 JSON 就是水到渠成的事。
回呼裡的 data 封裝了整包 JSON,data.comments 直接抵達內層陣列,再交給 $.each() 逐項取出欄位塞進 DOM:
代碼如下:
function loadInfo() {
$.getJSON("loadInfo", function (data) {
$("#info").html(""); // 清空容器
$.each(data.comments, function (i, item) {
$("#info").append(
"<div>" + item.id + "</div>" +
"<div>" + item.nickname + "</div>" +
"<div>" + item.content + "</div><hr/>");
});
});
}
loadInfo 是請求位址,function(data){...} 是成功後的回呼,data.comments 取出的是這個陣列:
[{"content":"很不錯嘛","id":1,"nickname":"納尼"},{"content":"喲西喲西","id":2,"nickname":"小強"}]
迴圈裡同時握有索引 i 與項目 item,要把資料插到哪裡、怎麼排序,都在這段裡決定。
實務上的 JSON 往往更複雜,例如同時有陣列、純文字欄位與鍵值對組成的 map。這時只要多寫幾層 $.each():
代碼如下:
{"comments":[{"content":"很不錯嘛","id":1,"nickname":"納尼"},{"content":"喲西喲西","id":2,"nickname":"小強"}],
"content":"你是木頭人,哈哈。","infomap":{"性別":"男","職業":"程序員","博客":"https://www.xxx.com/codeplus/"},"title":"123木頭人"}
對應的腳本:
代碼如下:
function loadInfo() {
$.getJSON("loadInfo", function (data) {
$("#title").append(data.title + "<hr/>");
$("#content").append(data.content + "<hr/>");
// 解析 map:參數變成 key 與 value
$.each(data.infomap, function (key, value) {
$("#mapinfo").append(key + "----" + value + "<br/><hr/>");
});
// 解析陣列
$.each(data.comments, function (i, item) {
$("#info").append(
"<div>" + item.id + "</div>" +
"<div>" + item.nickname + "</div>" +
"<div>" + item.content + "</div><hr/>");
});
});
}
$.each() 在遍歷 map(一般物件)時,回呼參數的語意是 key 與 value,而不是 index 與 item,這點很容易被忽略。另外,若 JSON 只需解析而不需跨域,用 $.ajax 搭配 dataType: "json" 的效果與 $.getJSON 相同,但後者語法更短。最後要留意 XSS:直接用字串拼接把後端資料塞進 append(),若內容可能含標籤,請改用 .text() 或先做轉義。