本文帶你看懂 jQuery 背後的設計哲學與核心特性,並實際寫幾個 Ajax 範例,最後說明如何以外掛擴充它。
jQuery 誕生於 2006 年,出自 John Resig 之手。無論你是想嘗試 DOM 與 Ajax 的 JavaScript 新手,還是已經厭倦反覆撰寫枯燥 DOM/Ajax 樣板程式碼的老手,jQuery 都能派上用場。
它幫助你保持程式碼的簡單與簡潔:不必再寫一大堆重複的迴圈與 DOM 呼叫,很快就能找到關鍵點,用極少的程式碼表達想法。jQuery 的哲學其實很單純——簡單、可重用。理解並認同這件事之後,你就會體會到用它寫程式有多輕鬆。
先看一個例子:為頁面上某個區域內的所有連結加上 click 事件。用原生 DOM 撰寫如下:
var external_links = document.getElementById('external_links');
var links = external_links.getElementsByTagName('a');
for (var i = 0; i < links.length; i++) {
var link = links.item(i);
link.onclick = function () {
return confirm('You are going to visit: ' + this.href);
};
}
改用 jQuery:
$('#external_links a').click(function () {
return confirm('You are going to visit: ' + this.href);
});
差異非常明顯:不必自己跑迴圈,click() 會處理好這一切,你要做的只是「描述你要找的元素」。
這裡有個小技巧。首先看 $() 函式——jQuery 中最有用、最強大的函式,絕大多數情況下你用它是為了從文件中選取元素。在範例中,傳入的是一段帶有 CSS 語法的字串,jQuery 靠它精準定位元素。如果你懂基本的 CSS 選擇器,這個語法應該看起來很熟悉:#external_links 找到 id 為 external_links 的元素,接著的空白表示要在該元素「裡面」找所有的 <a>。
$() 會回傳一個包含所有符合元素的 jQuery 物件。這個物件的概念有點像陣列,但同時具備許多 jQuery 方法。舉例來說,你可以直接呼叫 click,它就會為物件中的每個元素綁定事件。
此外,你也可以把元素或元素陣列傳給 $(),它會把這些元素打包成 jQuery 物件。這在處理 window 物件時特別有用。例如原本要寫:
window.onload = function () {
// 頁面全部載入完成後執行
};
用 jQuery 可以寫成:
$(window).load(function () {
// 整個頁面都下載完畢後執行
});
等待 window 的 load 是相當痛苦的,因為必須等所有圖片都載完。但大多數時候你只需要操作 HTML 標記本身。jQuery 為此在 document 上建立了一個特殊事件 ready:
$(document).ready(function () {
// HTML 準備好之後執行
});
這段程式碼建立一個 document 的 jQuery 物件,並在 DOM 就緒後執行。這個方法可以呼叫任意多次,而且還有更簡短的寫法——直接把函式傳給 $():
$(function () {
// HTML 下載完成後執行
});
第四種使用 $() 的方式,是用字串建立一個新元素,結果是一個含該元素的 jQuery 物件:
$('<p></p>')
.html('Hey World!')
.css('background', 'yellow')
.appendTo("body");
從這個例子可以看到 jQuery 另一個強大特性:方法鏈。每次對 jQuery 物件呼叫方法,該方法都會回傳同一個 jQuery 物件,因此可以不必重複寫選擇器,一路串接下去:
$('#message').css('background', 'yellow').html('Hello!').show();
jQuery 提供了一系列函式,讓簡單的事更簡單,讓複雜的事盡可能簡單。
Ajax 最常見的用法,就是把一段 HTML 載入到頁面的某個區域。做法是選中該元素,然後呼叫 load():
$('#stats').load('stats.html');
通常你需要同時傳一些參數給伺服器端頁面。用 $.post() 或 $.get() 都能做到,可以傳入一個選用的資料物件與回呼函式:
$.post('save.cgi', {
text: 'my string',
number: 23
}, function () {
alert('Your data has been saved.');
});
如果需要更複雜的控制,就改用 $.ajax()。你可以指定 dataType 為 xml、html、script 或 json,jQuery 會自動處理好結果,讓你的回呼函式能直接使用;也可以設定 beforeSend、error、success、complete 等回呼,給使用者更完整的回饋,此外還有逾時時間與「最後修改時間」等參數:
$.ajax({
url: 'document.xml',
type: 'GET',
dataType: 'xml',
timeout: 1000,
error: function () {
alert('Error loading XML document');
},
success: function (xml) {
// 處理 xml
}
});
拿到 XML 回應之後,你可以用操作 HTML 的方式來遍歷它,这让「讀取 XML 並整合進頁面」變得非常容易。以下範例在 success 中擴充,依 XML 裡每個 <item> 在頁面上增加一個清單項目:
success: function (xml) {
$(xml).find('item').each(function () {
var item_text = $(this).text();
$('<li></li>')
.html(item_text)
.appendTo('ol');
});
}
整套流程看下來,jQuery 的價值就在於:它把「選取元素」、「綁定事件」、「發送請求」、「處理回應」這四件原本各自繁瑣的事,收斂成一套一致的介面。