jQuery 是一個 JavaScript 函式庫,它的存在就是為了讓 JavaScript 與 Ajax 開發變得單純。與同類函式庫相比,jQuery 有個很鮮明的立場:用極簡潔的方式表達常見但繁瑣的程式碼。
jQuery 由 John Resig 於 2006 年初創建。不論你是剛接觸 JavaScript、想找一个能解決 DOM 腳本與 Ajax 難題的工具,還是已經厭倦了反覆抄寫 DOM 迴圈的資深工程師,它都值得一試。
需求很簡單:為頁面某區塊內的每個連結掛上單擊事件。純 JavaScript 加 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() 會替你對集合中的每個元素都掛上處理函式;也不必做多次 DOM 查詢,一個簡短的選擇器字串就定義好了目標。
要理解這段程式碼,得先理解 jQuery 中最強大的一個函數:$()。它最常見的用途是從文件中挑選元素。傳入一個帶有 CSS 語法的字串,jQuery 會以尽可能高的效率把符合的元素找出來。
如果你懂 CSS 選擇器,這裡的語法應該很熟悉:#external_links 取出 id 為 external_links 的元素,後面一個空格加上 a 表示要取出該元素內部的所有 <a>。用英文描述繞口,用 CSS 描述卻再自然不過。
$() 回傳的是一個包含所有相符元素的 jQuery 物件。它類似陣列,但附帶了大量專用的 jQuery 方法——例如呼叫 click,就能一次為物件裡的所有元素指定點擊處理函式。
$() 也能接受單一元素或元素陣列,把它們包裝成 jQuery 物件。這個能力很實用,比如要為 window 掛載載入事件:
$(window).load(function() {
// 整個頁面下載完成後執行
});
等待 window 的 load 事件往往慢得令人心浮氣躁,因為它必須等頁面上所有資源(包含每一張圖片)都下載完畢。大多數時候,你其實只需要 HTML 就夠了。jQuery 為此提供了 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();
最常見的 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() 上場。你可以指定回傳型別為 xml、script、html 或 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 幾乎一樣直覺。下面這個 success 函式為 XML 中的每個 <item> 元素在頁面上加一個清單項:
success: function(xml){
$(xml).find('item').each(function(){
var item_text = $(this).text();
$('<li></li>')
.html(item_text)
.appendTo('ol');
});
}
animate() 是動畫的核心,用來改變任何會隨時間變化的數值型 CSS 樣式——高度、寬度、透明度、位置都可以。速度可以給毫秒數,也可以用 slow/normal/fast 三個預設值。注意參數只寫最終值,起始值取自元素當前狀態:
$('#grow').animate({ height: 500, width: 500 }, "slow", function(){
alert('The element is done growing!');
});
更多常見效果已有現成函式:show()/hide() 可立即或"]).以特定速度顯示隱藏;fadeIn()/fadeOut() 走透明度路線;slideDown()/slideUp() 則是高度滑動。做一個下滑式導覽選單,一行就夠:
$('#nav').slideDown('slow');
或許這才是 jQuery 最擅長的領域。遍歷與操作 DOM 變得簡單,附加、移除、觸發事件也不容易出錯。
建立元素後可以用 append() 接上其他元素,用 clone() 複製,用 html() 設定內容,用 empty() 清空,用 remove() 刪除元素本身,用 wrap() 在外層包上新元素。
遍歷方面,可以取得所有 siblings()、parents()、children(),也可以用 next() 與 prev() 取前後兄弟。其中 find() 大概是最強的一個——它讓你用 jQuery 選擇器在目前物件的後代中搜尋。
搭配 end() 使用,這些方法會變得更強大。end() 的作用類似「復原」,回到呼叫 find() 或 parents() 之前的 jQuery 物件。和方法鏈接一起用,複雜的操作看起來會清爽很多:
$('form#login')
// 隱藏表單中所有 optional 類別的 label
.find('label.optional').hide().end()
// 為密碼欄位加上紅色邊框
.find('input:password').css('border', '1px solid red').end()
// 掛上表單提交處理
.submit(function(){
return confirm('Are you sure you want to submit?');
});
這整段是一行鏈接完成的。先選表單,找出 optional 標籤並隱藏,end() 回到表單;接著找密碼欄位加紅框,再 end() 回到表單;最後掛上提交事件。除了簡潔,更關鍵的是 jQuery 會最佳化所有查詢,確保鏈接之後不會對同一個元素重複查詢兩次。
處理事件就像呼叫函式一樣簡單:click()、submit()、mouseover(),傳入處理函式即可。自訂事件則用 bind('eventname', function(){}),移除用 unbind('eventname'),全部移除則直接 unbind()。
我們平常最常用 ID(#myid)或類別(div.myclass)選元素。但 jQuery 的選擇器語法更完整,幾乎能在單一選擇器中描述任何元素組合。它的語法主要取自 CSS3 與 XPath——這兩者懂得越多,用 jQuery 就越順手。
CSS3 有些語法並非所有瀏覽器都支援,但因為 jQuery 自帶選擇器引擎,你仍然可以在 jQuery 裡放心使用。例如替表格中每一格空白的儲存格補上一個破折號:
$('td:empty').html('-');
要找出所有不含特定 class 的元素,用 :not 偽類別:
$('input:not(.required)').hide();
和 CSS 一樣,用逗號可以一次串多個選擇器:
$('ul, ol, dl').hide();
XPath 是另一套強大的搜尋語法,功能比 CSS 略多一些。要為所有核取方塊的父元素加上邊框,可以用 XPath 的 /.. 語法:
$("input:checkbox/..").css('border', '1px solid #777');
jQuery 也有 CSS 與 XPath 都沒有的選擇器。例如要讓表格更易讀,通常會替奇數或偶數行加上不同 class(所謂 striping),用 odd 偽類別輕鬆就能做到:
$('table.striped > tr:odd').css('background', '#999999');
不論你要處理的是具體還是模糊的元素,幾乎都能找到一個 jQuery 選擇器把它定義出來。
與多數軟體不同,為 jQuery 寫外掛一點也不難,甚至簡單到讓你想自己動手做幾個。最基礎的外掛長這樣:
$.fn.donothing = function(){
return this;
};
兩個要點:第一,要為每個 jQuery 物件加上函式,必須把它指派給 $.fn;第二,函式必須回傳 this(也就是 jQuery 物件本身),否則方法鏈接就斷了。
在這個基礎上加點東西,就能寫一個換背景色的外掛,取代 css('background'):
$.fn.background = function(bg){
return this.css('background', bg);
};
因為 css() 本身就回傳 jQuery 物件,鏈接在這裡依然運作良好。建議在遇到重複性工作時就寫成外掛——例如某段 each() 邏輯你已經寫到第三次,就是該抽成外掛的時候了。
由於門檻低,社群累積的外掛數量相當可觀:表格、圓角、滑動顯示、工具提示、日期選擇器,幾乎想得到的效果都有。最複雜也最廣泛被使用的莫過於 Interface——一個處理排序、拖放、複雜動畫與 UI 效果的專案,它對 jQuery 的地位有點像 Scriptaculous 之於 Prototype。表單外掛同樣熱門,它能用 Ajax 在背景輕鬆送出表單,幫你處理「攔截 submit 事件、收集所有輸入欄位、組出 Ajax 呼叫」這一整套常見流程。
以上只是 jQuery 能力的概略介紹。用 jQuery 寫程式是件愉快的事,因此總能學到看起來很簡單的新技巧。從開始使用的那一刻起,它就替你簡化了 JavaScript 與 Ajax 開發;每多懂一點,程式碼就更短一些。
我自己最大的收穫是:不必再操心那些無聊的樣板程式,可以把注意力放在真正有趣的部分。自從用了 jQuery,我幾乎告別了撰寫 for 迴圈的日子——它確實改變了我對 JavaScript 開發的看法。