jQuery 最大的價值在於「把想法直接寫成程式」。同一件事,用原生 DOM 可能要十行,用 jQuery 一行就夠。以下從選擇器一路談到 Ajax、動畫、外掛。
要為某區塊內的每個連結加上「即將離開本站」的確認:
// 純 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 最強的函式,有四種典型用法:
// 1. 選擇器(含 CSS 語法)
$('#external_links a')
// 2. 包裝既有元素或 window 等物件
$(window).load(function() { /* ... */ });
// 3. DOM 就緒
$(document).ready(function() { /* ... */ });
$(function() { /* 等價的快捷寫法 */ });
// 4. 由 HTML 字串建立元素
$('<p></p>')
.html('Hey World!')
.css('background', 'yellow')
.appendTo("body");
為什麼不建議用 window.onload?因為它必須等整頁所有資源(含圖片)都下載完才觸發。jQuery 的 ready 事件在 DOM 就緒時就執行,實用得多。
每個 jQuery 方法都會回傳同一個 jQuery 物件,所以可以一路串下去,不必重複寫選擇器:
$('#message').css('background', 'yellow').html('Hello!').show();
// 最簡單:載入一段 HTML
$('#stats').load('stats.html');
// 帶參數並接回呼
$.post('save.cgi', {
text: 'my string',
number: 23
}, function() {
alert('Your data has been saved.');
});
// 需要完整控制時
$.ajax({
url: 'document.xml',
type: 'GET',
dataType: 'xml',
timeout: 1000,
error: function() { alert('Error loading XML document'); },
success: function(xml) {
$(xml).find('item').each(function() {
var item_text = $(this).text();
$('<li></li>').html(item_text).appendTo('ol');
});
}
});
dataType 可指定 xml、script、html 或 json,jQuery 會自動把回應轉成對應型別;beforeSend、error、success、complete 都能用來給使用者回饋。
$('#grow').animate({ height: 500, width: 500 }, "slow", function() {
alert('The element is done growing!');
});
$('#nav').slideDown('slow');
animate() 是核心,可改變任何數值型的 CSS 屬性(高度、寬度、透明度、位置),速度可指定毫秒或 slow / normal / fast。若只是顯示隱藏,show()、hide()、fadeIn()、fadeOut()、slideUp()、slideDown() 更直接。
常用操作:append() 附加、clone() 複製、html() 設內容、empty() 清空、remove() 刪除、wrap() 包一層。
遍歷:siblings()、parents()、children()、next()、prev(),以及最強的 find()(在現有集合中搜尋後代)。搭配 end() 就能回到前一次操作前的集合,像 undo 一樣。
$('form#login')
// 隱藏表單內 class 為 optional 的 label
.find('label.optional').hide().end()
// 為密碼欄位加上紅色邊框
.find('input:password').css('border', '1px solid red').end()
// 掛上 submit 處理器
.submit(function() {
return confirm('Are you sure you want to submit?');
});
這整段其實只有一行。除了簡潔,jQuery 還會優化查詢,確保同一個元素不會被查兩次。
事件除了 click()、submit()、mouseover() 這類簡寫,也能用 bind('eventname', fn) 註冊、unbind('eventname') 移除,unbind() 則一次清掉全部。
jQuery 的選擇器語法主要取自 CSS3 與 XPath,並加上自己的擴充:
$('td:empty').html('-'); // 空的儲存格填橫槓
$('input:not(.required)').hide(); // 隱藏非必填欄位
$('ul, ol, dl').hide(); // 多選擇器
$("input:checkbox/..").css('border', '1px solid #777'); // XPath 取父元素
$('table.striped > tr:odd').css('background', '#999999'); // 斑馬線
$.fn.donothing = function() {
return this;
};
$.fn.background = function(bg) {
return this.css('background', bg);
};
兩個要點:函式要掛在 $.fn 上,而且必須 return this,否則方法鏈接會斷掉。
如果某段 each() 反覆出現,就該考慮抽成外掛。jQuery 的官方外掛生態相當龐大,表格、圓角、滑動顯示、提示框、日期選擇器應有盡有;其中 Interface 是最複雜也最廣泛使用的一套(排序、拖放、複雜動畫),地位相當於 Prototype 的 Scriptaculous。表單外掛也很實用,能自動攔截 submit、收集欄位並轉為 Ajax 呼叫。