這份整理把日常寫 jQuery 最常翻的 API 集中在一頁,從最基礎的「jQuery 物件跟 DOM 物件差在哪」一路到自製外掛。適合當速查表用。
用 $() 引用元素(無論是透過 id、class、標籤名、階層關係或 DOM/XPath 條件)拿到的都是 jQuery 物件,也就是一個集合,不能直接呼叫 DOM 原生方法。
兩者可以互相轉換。把原生 DOM 物件丟進 $() 就變成 jQuery 物件:
$(document.getElementById("msg")); // 這之後就能用 jQuery 的方法了
反過來,因為 jQuery 物件是集合,要轉回 DOM 物件必須取出其中一項,通常用索引:
$("#msg")[0]
$("div").eq(1)[0]
$("div").get()[1]
$("td")[5]
這些取出來的都是 DOM 物件,只能用 DOM 的方法,不能再用 jQuery 的方法。以下幾種寫法都正確:
$("#msg").html();
$("#msg")[0].innerHTML;
$("#msg").eq(0)[0].innerHTML;
$("#msg").get(0).innerHTML;
關鍵差異:eq() 回傳 jQuery 物件,get(n) 與索引回傳 DOM 物件。
$("div").eq(2).html(); // 走 jQuery 的方法
$("div").get(2).innerHTML; // 走 DOM 的屬性
jQuery 大量採用這種設計:不帶參數是取值,帶參數是設值。
$("#msg").html(); // 取得 HTML 內容
$("#msg").html("<b>new content</b>"); // 寫入 HTML,畫面顯示粗體
$("#msg").text(); // 取得純文字內容
$("#msg").text("<b>new content</b>"); // 當成純文字寫入,畫面直接顯示 <b>new content</b>
$("#msg").height(); $("#msg").height("300");
$("#msg").width(); $("#msg").width("300");
$("input").val(); $("input").val("test");
$("#msg").click(); // 觸發 click
$("#msg").click(fn); // 綁定 click 處理函式
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 加上 click,點了就跳出內容
$("p").click(function(){ alert($(this).html()); });
用 $.extend 就能往 jQuery 掛新功能:
$.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));
所謂鏈式,就是對同一個 jQuery 物件連續呼叫不同方法,中間不必重複查詢:
$("p").click(function(){ alert($(this).html()); })
.mouseover(function(){ alert('mouse over event'); })
.each(function(i){ this.style.color = ['#f00','#0f0','#00f'][i]; });
$("#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"); // 有就移除、沒有就加上
不必把事件寫在 HTML 標籤上,直接對 jQuery 物件綁定即可:
$("#msg").click(function(){ alert("good"); });
$("p").click(function(i){ this.style.color = ['#f00','#0f0','#00f'][i]; });
hover(fn1, fn2):模擬懸停。滑鼠移入觸發第一個函式,移出觸發第二個。
$("tr").hover(
function(){ $(this).addClass("over"); },
function(){ $(this).addClass("out"); }
);
ready(fn):DOM 就緒後執行,等價於 $(fn)。
$(document).ready(function(){ alert("Load Success"); });
toggle(fn1, fn2):每次點擊輪流呼叫兩個函式。
$("p").toggle(
function(){ $(this).addClass("selected"); },
function(){ $(this).removeClass("selected"); }
);
trigger(type):觸發指定事件。
$("p").trigger("click"); // 觸發所有 p 的 click
bind / unbind:綁定與解除綁定。
$("p").bind("click", function(){ alert($(this).text()); });
$("p").unbind(); // 移除所有事件
$("p").unbind("click"); // 只移除 click
(補充:jQuery 1.7 之後,bind/unbind 已被 on/off 取代,新專案建議直接用 on/off,事件委派寫成 $(document).on('click', '.item', fn)。)
toggle() 與 slideToggle() 提供了狀態切換的便利:前者涵蓋了 hide() 與 show(),後者涵蓋了 slideDown() 與 slideUp()。做折疊面板時,一個 slideToggle() 就搞定。
$.each(obj, fn)——通用迭代器,可處理陣列與物件:
$.each([0,1,2], function(i, n){ alert("Item #" + i + ": " + n); });
// 也可處理 JSON 物件
$.each({ name: "John", lang: "JS" }, function(i, n){
alert("Name: " + i + ", Value: " + n);
});
$.extend(target, ...)——用一個或多個物件擴充目標物件,是 jQuery 的繼承機制:
$.extend(settings, options); // 合併後存回 settings
var settings = $.extend({}, defaults, options); // 不覆蓋 defaults
$.map(array, fn)——陣列映射:
var a = $.map([0,1,2], function(i){ return i + 4; }); // [4,5,6]
var b = $.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)——移除字串兩端空白:
$.trim(" hello, how are you? ");
$.browser——瀏覽器偵測(回傳 safari、opera、msie、mozilla 等)。注意:這個方法在 jQuery 1.9 已移除,請改用功能偵測或 Modernizr。
如果你自己也寫了 $(id),或者專案同時載入了 Prototype 這類同樣定義了 $ 的函式庫,就會撞車。jQuery 提供了現成解法:
jQuery.noConflict();
// 之後改用 jQuery 這個名稱
jQuery("div p").hide();
// 其他函式庫的 $() 照常可用
$("content").style.display = 'none';
常見做法是把整段程式包進IIFE,把 jQuery 傳進去當作區域的 $,這樣既不必到處改寫,也不會污染全域:
(function($){
$(document).ready(function(){
$("div p").hide();
});
})(jQuery);