jQuery 提供了功能強大的 DOM 讀取與處理方式,讓動態操作文件變得輕鬆。
$(document).ready(function() {
$("a").click(function() {
alert("Hello world!");
});
});
單擊文件中任一個連結都會觸發 alert。$ 是 jQuery 類的別名,$() 構造出一個新的 jQuery 物件;click() 是它的方法,把單擊事件綁定到所有選中的標籤(這裡是全部 a 標籤),事件觸發時執行提供的 alert。這種「結構與行為分離」的寫法,比在 HTML 裡寫 onclick 清爽得多。
jQuery 提供兩種挑選 HTML 元素的方式:第一種是把 CSS 與 XPath 選擇器組合成字串傳進構造器,例如 $("div > ul a");第二種是呼叫 jQuery 物件的方法。兩者也可以混用。
<ul id="orderedlist">
<li>食品</li>
<li>服裝</li>
<li>電子</li>
</ul>
取代原本的 document.getElementById('orderlist'):
$(document).ready(function() {
$("#orderedlist").addClass("red");
});
為子節點加上樣式:
$(document).ready(function() {
$("#orderedlist > li").addClass("blue");
});
滑鼠移入/移出時切換樣式:
$(document).ready(function() {
$("#orderedlist li:last").hover(function() {
$(this).addClass("green");
}, function() {
$(this).removeClass("green");
});
});
注意 $("#orderedlist li") 與 $("#orderedlist > li") 的差別:前者是後代選擇器,會抓到父元素下所有符合條件的後代;後者是子選擇器,只抓直接子元素。
用 find() 在已選集合中繼續搜尋,並用 each() 逐一處理:
$(document).ready(function() {
$("#orderedlist").find("li").each(function(i) {
$(this).html( $(this).html() + " BAM! " + i );
});
});
find() 讓你在已選元素中做條件查找,因此 $("#orderedlist").find("li") 等同於 $("#orderedlist li")。each() 逐一迭代所有 li;而大部分方法(如 addClass())內部本來就用了自己的 each。
// 重置單一個表單
$(document).ready(function() {
$("#reset").click(function() {
$("#form")[0].reset();
});
});
// 一次重置多個表單
$(document).ready(function() {
$("#reset").click(function() {
$("form").each(function() {
this.reset();
});
});
});
第一個範例用 [0] 把 jQuery 物件轉回 DOM 物件,才能呼叫原生的 reset();第二個則用 each 遍歷所有 form。
不想選到某些特定元素時,可用 filter() 與 not()。filter() 以過濾表達式縮小集合,not() 則排除符合條件的項目。
$(document).ready(function() {
$("li").not("[ul]").css("border", "1px solid black");
});
這裡的 [expression] 語法源自 XPath,可用於元素與屬性過濾,例如選出所有帶 name 屬性的連結:
$(document).ready(function() {
$("a[name]").background("#eee");
});
更常見的是選出 href 具有某段特征的連結。由於不同瀏覽器對 href 的解析可能有差異,用部分比對 *= 會比完全比對 = 安全:
$(document).ready(function() {
$("a[href*=/content/gallery]").click(function() {
// 處理所有指向 /content/gallery 的連結
});
});
$(document).ready(function() {
$('#faq').find('dd').hide().end().find('dt').click(function() {
var answer = $(this).next();
if (answer.is(':visible')) {
answer.slideUp();
} else {
answer.slideDown();
}
});
});
這裡用了鏈式表達法來精簡程式碼:#faq 只選一次,end() 會把前一次 find() 的效果復原,因此可以接著寫 find('dt'),不必重複 $('#faq').find('dt')。點擊時用 $(this).next() 找到緊接在 dt 後面的 dd,快速定位到對應答案。
slideUp(speed, [callback]):透過高度變化(向上縮減)動態隱藏符合的元素,可選地在隱藏完成後觸發回呼函式。slideDown(speed, [callback]):透過高度變化(向下增大)動態顯示元素,形成「滑動」出現的效果。$(document).ready(function() {
$("a").hover(function() {
$(this).parents("p").addClass("highlight");
}, function() {
$(this).parents("p").removeClass("highlight");
});
});
滑鼠移到段落中的連結時,讓它的父元素(也就是該段落)高亮顯示。
$(function() {
// code to execute when the DOM is ready
});
套回 Hello world 範例:
$(function() {
$("a").click(function() {
alert("Hello world!");
});
});
$(document).ready(function() {
// 動態產生評分連結
var ratingMarkup = ["Please rate: "];
for(var i=1; i <= 5; i++) {
ratingMarkup[ratingMarkup.length] = "<a href='#'>" + i + "</a> ";
}
// 加入容器並綁定點擊事件
$("#rating").append( ratingMarkup.join('') ).find("a").click(function(e) {
e.preventDefault();
// 送出請求
$.post("rate.php", {rating: $(this).html()}, function(xml) {
// 格式化結果
var result = [
"Thanks for rating, current average: ",
$("average", xml).text(),
", number of votes: ",
$("count", xml).text()
];
// 輸出結果
$("#rating").html(result.join(''));
});
});
});
這段程式碼產生 5 個連結並附加到 id 為 rating 的容器中。點擊任一連結時,該分數會以 rating 參數送到 rate.php,伺服器以 XML 回傳結果,再替換掉原本的連結。
$(function() {
var addClickHandlers = function() {
$("a.clickMeToLoadContent").click(function() {
$("#target").load(this.href, addClickHandlers);
});
};
addClickHandlers();
});
addClickHandlers 只在 DOM 載入完成後執行一次,之後每次點擊帶有該 class 的連結並完成內容載入時,就會再重新綁定一次事件。刻意定義成區域變數而非全域函式,是為了避免與其他全域變數或函式命名衝突。
// 取得資料
var foobar = ...;
// 指定需要參數的處理器
var handler = function(data) {
...
};
// 綁定點擊事件並傳入 foobar
$('a').click( function(event) { handler(foobar); } );
// 若需要保留原始 handler 的 this 上下文,使用 apply
$('a').click( function(event) { handler.apply(this, [foobar]); } );
$(document).ready(function() {
$("a").toggle(function() {
$(".stuff").hide('slow');
}, function() {
$(".stuff").show('fast');
});
});
搭配 animate() 可以做出滑動加淡出的複合效果:
$(document).ready(function() {
$("a").toggle(function() {
$(".stuff").animate({
height: 'hide',
opacity: 'hide'
}, 'slow');
}, function() {
$(".stuff").animate({
height: 'show',
opacity: 'show'
}, 'slow');
});
});
toggle(fn, fn):每次點擊輪番呼叫函式。第一次點擊觸發第一個函式,再點一次觸發第二個,以此類推並循環。可用 unbind("click") 移除。
animate(params, options):自製動畫的核心函式。params 物件的每個屬性代表一個可變化的樣式屬性(如 height、top、opacity),值代表動畫結束時該屬性要達到多少;若是數值則從目前值漸變過去,若是 "hide"、"show"、"toggle" 則套用該屬性的預設動畫。屬性名稱務必使用駝峰式,例如寫 marginLeft 而非 margin-left。
$("#go1").click(function(){
$("#block1").animate( { width: "90%"}, { queue: false, duration: 5000 } )
.animate( { fontSize: '10em' } , 1000 )
.animate( { borderWidth: 5 }, 1000);
});
$("#go2").click(function(){
$("#block2").animate( { width: "90%"}, 1000 )
.animate( { fontSize: '10em' } , 1000 )
.animate( { borderWidth: 5 }, 1000);
});
先在頁面中引入外掛:
<script src="lib/jquery.tablesorter.js" type="text/javascript"></script>
再告訴外掛哪個表格要排序:
$(document).ready(function() {
$("#large").tableSorter();
});
點擊表頭第一列即可排序,再點一次則反向排列。加上隔行底色(斑馬線)效果更好:
$(document).ready(function() {
$("#large").tableSorter({
stripingRowClass: ['odd','even'], // 隔行樣式類名,以陣列提供
stripRowsOnStartUp: true // 初始化時就套用隔行底色
});
});
寫 jQuery 外掛其實很容易,照著下面的原則做,別人也能輕我便用你的外掛:
foobar。jquery.[yourpluginname].js 檔案,例如 jquery.foobar.js。jQuery.fn.foobar = function() {
// do something
}
jQuery.fooBar = {
height: 5,
calculateBar = function() { ... },
checkDependencies = function() { ... }
}
之後就能在外掛中呼叫這些輔助函式:
jQuery.fn.foobar = function() {
// do something
jQuery.foobar.checkDependencies(value);
// do something else
};
jQuery.fn.extend(object):擴充 jQuery 元素集以提供新方法,通常用來製作外掛。
jQuery.fn.extend({
check: function() {
return this.each(function() { this.checked = true; });
},
uncheck: function() {
return this.each(function() { this.checked = false; });
}
});
使用結果:
$("input[type=checkbox]").check();
$("input[type=radio]").uncheck();
jQuery.fn.foobar = function(options) {
var settings = {
value: 5,
name: "pete",
bar: 655
};
if(options) {
jQuery.extend(settings, options);
}
}
jQuery.extend(target, obj1, [objN]):用一個或多個物件擴充目標物件並回傳,常用來簡化繼承。
var settings = { validate: false, limit: 5, name: "foo" };
var options = { validate: true, name: "bar" };
jQuery.extend(settings, options);
// 結果:settings == { validate: true, limit: 5, name: "bar" }
現在不帶任何參數也能使用外掛,此時預設值生效:
$("...").foobar();
或自行指定:
$("...").foobar({
value: 123,
bar: 9
});
如果要發布外掛,記得附上範例與文件——大部分優質外掛都有完善的參考文件。
很多人會這樣控制 radio 或 checkbox 的選取狀態:
$("input[type='checkbox']").each(function() {
this.checked = true; // 全選
// this.checked = false; // 取消全選
// this.checked = !this.checked; // 反選
});
在 jQuery 1.2 以上版本,選取所有 checkbox 應寫成 input:checkbox:
$('input:checkbox').each(function() { ... });
無論何時,只要程式碼裡出現 each,就該把它重寫成外掛。
$.fn.check = function() {
return this.each(function() {
this.checked = true;
});
};
現在可以這樣用:
$('input:checkbox').check();
接著讓外掛接受參數:
$.fn.check = function(mode) {
var mode = mode || 'on'; // mode 未定義時,預設用 'on'
return this.each(function() {
switch(mode) {
case 'on':
this.checked = true;
break;
case 'off':
this.checked = false;
break;
case 'toggle':
this.checked = !this.checked;
break;
}
});
};
因為設了預設值,省略參數也可以:
$("input[type='checkbox']").check();
$("input[type='checkbox']").check('on');
$("input[type='checkbox']").check('off');
$("input[type='checkbox']").check('toggle');
若參數多於一個,而只想設定後面的參數,得在前面的位置填 null。更理想的做法是像 tablesorter 那樣,全部用 key/value 物件傳入。
最後練習把評分功能改寫成外掛,骨架如下:
$.fn.rateMe = function(options) {
var container = this; // 不再用 $("#rating") 選固定容器,而是使用 jQuery 上下文
var settings = {
url: "rate.php"
// 在這裡補上更多預設值
// 注意每組之間要加逗號,最後一組不要加!
};
if(options) { // 擴充前先確認 options 是否存在
$.extend(settings, options);
}
// ...
// 其餘程式碼
// ...
return this; // 盡量回傳 this,以免破壞鏈式呼叫
});