如果每次請求都要連標籤一起傳,那麼當你只想取幾筆資料時,頻寬就浪費在標籤上了。理想的做法是傳回一個能直接用JavaScript遍歷的結構,前端拿到後再決定怎麼呈現。
JavaScript物件是「鍵—值」對的集合,以花括號定義;陣列則以方括號搭配遞增索引動態產生。兩者一併用,再複雜的巢狀結構都能寫得清楚。Douglas Crockford把這套語法整理命名為JSON,用來取代肥大的XML:
{
"key": "value",
"key 2": ["array", "of", "items"]
}
JSON的規則很嚴格:物件的鍵與所有字串值都必須使用雙引號,函式不能當值。因此手工編輯容易出錯,正式專案應交由伺服器端程式輸出。想查完整的語法規範與各語言支援狀況,可參考 json.org。
以下是一份示範用的詞條資料 b.json:
[
{
"term": "BACCHUS",
"part": "n.",
"definition": "A convenient deity invented by the...",
"quote": [
"Is public worship, then, a sin,",
"That for devotions paid to Bacchus",
"The lictors dare to run us in,",
"And resolutely thump and whack us?"
],
"author": "Jorace"
},
{
"term": "BACKBITE",
"part": "v.t.",
"definition": "To speak of a man as you find him when..."
}
]
$.getJSON() 會抓取檔案、解析字串,再把JavaScript物件交給呼叫端。
一般jQuery方法都要先 $() 建立物件,因為它們操作的對象是選中的DOM節點。但 $.getJSON() 沒有對應的DOM元素,結果只餵給程式碼。所以它被定義在全域jQuery物件上,而不是個別執行個體的方法。用物件導向的語言來類比,它比較接近「類方法」;掛在jQuery命名空間底下則是為了避免命名衝突。
$(document).ready(function() {
$('#letter-b a').click(function(event){
event.preventDefault();
$.getJSON('b.json');
});
});
這樣寫檔案會載入,但畫面毫無變化——因為沒有告訴JavaScript如何處理回傳值。
$(document).ready(function() {
$('#letter-b a').click(function(event){
event.preventDefault();
$.getJSON('b.json', function(data){
// data 即為解析後的物件
});
});
});
第二個參數就是載入完成後要呼叫的函式。由於AJAX是非同步的,回呼讓程式得以「等資料回來再執行」,而不是空等。回呼透過參數取得資料,這裡用匿名函式保持精簡,用具名函式參照也完全可行。
$(document).ready(function() {
$('#letter-b a').click(function(event){
event.preventDefault();
$.getJSON('b.json', function(data){
var html = '';
$.each(data, function(entryIndex, entry){
html += '<div class="entry">';
html += '<h3 class="term">' + entry.term + '</h3>';
html += '<div class="part">' + entry.part + '</div>';
html += '<div class="definition">' + entry.definition + '</div>';
html += '</div>';
});
$('#dictionary').html(html);
});
});
});
$.each() 不操作jQuery物件,它吃「陣列或物件 + 回呼函式」,回呼再帶入索引與項目。組完HTML後,用 .html() 寫入目標容器,原內容會被整批取代。
安全提醒:這段邏輯假設資料本身可以安全嵌入HTML,也就是不含任何 < 字元。
$.each(entry.quote, function(lineIndex, line){
html += '<div class="quote-line">' + line + '</div>';
});
if (entry.author){
html += '<div class="quote-author">' + entry.author + '</div>';
}
把這段嵌進原本的 $.each() 裡,就能把引用與出處一併呈現。完成後點擊B字母連結,右側會列出對應詞條。
JSON簡潔,卻一個符號都不能錯。括號、引號、逗號只要有一處不對,檔案就載不進來;而且多數瀏覽器不會顯示任何錯誤,腳本會靜默中止。除錯時不妨先把JSON貼進驗證器檢查一遍,能省下大量時間。