寫 jQuery 久了會發現,真正影響開發速度的往往不是 API 記得多不多,而是幾個觀念有沒有釐清——尤其是 jQuery 物件與 DOM 物件的界線。以下十二則是實務上最常回頭查的筆記。
jQuery 的 $() 可以用 id、class、標籤名、層級關係、DOM 或 XPath 條件等多種方式選取元素,回傳的是 jQuery 物件(集合),不能直接呼叫 DOM 原生方法。
只有 jQuery 物件才能用 jQuery 的方法。兩者的界線必須清楚:
// DOM → jQuery:用 $() 包起來
$(document.getElementById("msg"))
// jQuery → DOM:取出集合中的某一項
$("#msg")[0]
$("div").eq(1)[0]
$("div").get()[1]
$("td")[5]
以下四種寫法都正確,但前兩者是 jQuery 物件、後兩者是 DOM 物件:
$("#msg").html(); // jQuery 方法
$("#msg")[0].innerHTML; // DOM 屬性
$("#msg").eq(0)[0].innerHTML; // 先 jQuery 再轉 DOM
$("#msg").get(0).innerHTML; // get() 直接回傳 DOM
eq(n) 與 get(n) 都能取項目,但回傳型別不同:eq() 回 jQuery 物件,get() 與索引回 DOM 元素。
$("div").eq(2).html(); // 用 jQuery 方法
$("div").get(2).innerHTML; // 用 DOM 屬性
這個差異是新手 bug 的溫床:混用會直接丟出「該方法未定義」。
$("#msg").html(); // 取得 HTML 內容
$("#msg").html("new content"); // 寫入 HTML(會被解析成標籤)
$("#msg").text(); // 取得純文字
$("#msg").text("new content"); // 寫入純文字(標籤會被轉義)
$("#msg").height(); $("#msg").height("300");
$("#msg").width(); $("#msg").width("300");
$("input").val(); $("input").val("test");
$("#msg").click(); // 觸發單擊事件
$("#msg").click(fn); // 綁定單擊處理函式
blur、focus、select、submit 等事件同樣具備這兩種呼叫形式。這種「不帶參數就是讀、帶參數就是寫」的設計貫穿整個 jQuery,記住一次終身受用。
// 依索引給不同顏色
$("p").each(function(i){ this.style.color = ['#f00','#0f0','#00f'][ i ]; });
// 表格隔行變色
$("tr").each(function(i){ this.style.backgroundColor = ['#ccc','#fff'][i % 2]; });
// 為每個 p 綁事件
$("p").click(function(){ alert($(this).html()) });
each 的回呼裡,this 是當前的 DOM 元素;要用 jQuery 方法時得寫 $(this)。
$.extend({
min: function(a, b){ return a < b ? a : b; },
max: function(a, b){ return a > b ? a : b; }
});
alert("a=10,b=20,max=" + $.max(10,20) + ",min=" + $.min(10,20));
$("p").click(function(){ alert($(this).html()) })
.mouseover(function(){ alert('mouse over event') })
.each(function(i){ this.style.color = ['#f00','#0f0','#00f'][ i ] });
之所以能串起來,是因為大多數 jQuery 方法都會 return this。自己寫插件時別忘了這點。
$("#msg").css("background"); // 讀取背景色
$("#msg").css("background", "#ccc") // 設定背景灰
$("#msg").height(300); $("#msg").width("200");
$("#msg").css({ color:"red", background:"blue" }); // 傳入物件批次設定
$("#msg").addClass("select"); // 加上 class
$("#msg").removeClass("select"); // 移除 class
$("#msg").toggleClass("select"); // 有則移除、無則加上
hover(fn1, fn2) 模仿懸停:移入觸發 fn1,移出觸發 fn2。
$("tr").hover(
function(){ $(this).addClass("over"); },
function(){ $(this).addClass("out"); }
);
ready(fn) DOM 就緒後執行,等同 $(fn)。
toggle(evenFn, oddFn) 每次點擊輪番觸發兩個函式。
$("p").toggle(
function(){ $(this).addClass("selected"); },
function(){ $(this).removeClass("selected"); }
);
trigger(eventType) 主動觸發事件,例如 $("p").trigger("click")。
bind/unbind 綁定與解除綁定。
$("p").bind("click", function(){ alert($(this).text()); });
$("p").unbind(); // 移除所有事件
$("p").unbind("click"); // 只移除 click
$.browser 瀏覽器偵測,有效值為 safari、opera、msie、mozilla,例如 $.browser.msie。注意此 API 已在 jQuery 1.9 移除。
$.each([0,1,2], function(i, n){ alert("Item #" + i + ": " + n); });
// 也可迭代物件
$.each({ name:"John", lang:"JS" }, function(i, n){
alert("Name: " + i + ", Value: " + n);
});
$.extend(target, prop1, propN) 物件合併,是 jQuery 的繼承機制。
$.extend(settings, options); // 併入 settings 並回傳它
var settings = $.extend({}, defaults, options); // 不污染 defaults
第二種寫法特別重要:第一個參數給空物件,就能在合併的同時保留 defaults 原樣,避免多處共用同一份預設值時互相干擾。
$.map(array, fn) 陣列映射,回傳值為 null 的項目會被跳過。
$.map([0,1,2], function(i){ return i + 4; }); // [4,5,6]
$.map([0,1,2], function(i){ return i > 0 ? i + 1 : null; }); // [2,3]
$.merge(arr1, arr2) 合併並去除重複,$.merge([0,1,2],[2,3,4]) 得 [0,1,2,3,4]。
$.trim(str) 去除字串兩端空白。
很多函式庫都定義了 $,一起載入時必然打架。jQuery 提供了官方解法:
jQuery.noConflict();
// 之後改用 jQuery 取代 $
jQuery("div p").hide();
// 其他函式庫的 $ 照常可用
$("content").style.display = 'none';
另一種常見寫法是包成立即執行函式,把 $ 作為區域參數傳進去,這樣在閉包內仍可照舊使用 $:
(function($){
$(document).ready(function(){ /* 這裡的 $ 就是 jQuery */ });
})(jQuery);