這份手冊把 jQuery 的工具函數整理成可查閱的型式,耐心看完基本就能入門。
$(function(){
if($.browser.msie) {
alert("這是一個 IE 瀏覽器");
}
else if($.browser.opera) {
alert("這是一個 Opera 瀏覽器");
}
})
頁面載入時判斷瀏覽器類型,可判斷的種類有 msie、mozilla、opera、safari。要提醒的是,瀏覽器嗅探在現代開發中已被視為反模式——它判斷的是「這是哪個瀏覽器」,而不是「這個瀏覽器支不支援我要用的功能」。實務上請優先改用特性偵測。
obj 為物件或陣列,fn 為在其上依序執行的函數。注意與 jQuery 物件上的 $().each() 區分開來。
$.each( [0,1,2], function(i){ alert( "Item #" + i + ": " + this ); });
會分別把 0、1、2 傳入 function(i)。傳入 hash 物件時:
$.each({ name: "John", lang: "JS" }, function(i){ alert( "Name: " + i + ", Value: " + this ); });
則會依序把每一組 key/value 傳進函式。
用第二個物件擴展第一個物件。
var settings = { validate: false, limit: 5, name: "foo" };
var options = { validate: true, name: "bar" };
$.extend(settings, options);
執行後 settings 變成 { validate: true, limit: 5, name: "bar" }——同名的 key 被覆寫,沒被提到的 limit 則保留下來。可以用下面的程式驗證:
$(function(){
var settings = { validate: false, limit: 5, name: "foo" };
var options = { validate: true, name: "bar" };
$.extend(settings, options);
$.each(settings, function(i){ alert( i + "=" + this ); });
})
這個方法是 jQuery 外掛寫作的基礎:把使用者傳入的 options 合併到預設值上,就能做出既安全又可自訂的設定物件。
把 array 中的元素逐一傳給 fn,fn 必須回傳布林值。
$(function(){
var arr = $.grep( [0,1,2,3,4], function(i){ return i > 2; });
$.each(arr, function(i){ alert(i); });
})
執行後 [0,1,2,3,4] 被過濾成 [3,4]。順帶一提,若希望回傳「不符合條件」的那些,可以在第三個參數傳 true 做反轉。
兩個參數都是陣列,排除第二個陣列中與第一個重複的部分,再合併成一個。
$(function(){
var arr = $.merge( [0,1,2], [2,3,4] )
$.each(arr, function(i){ alert(i); });
})
結果是 [0,1,2,3,4]。
$.trim(" hello, how are you? ") // "hello, how are you?"
處理表單輸入時幾乎都會用到,尤其在把使用者輸入送去驗證或寫入資料庫之前,先 trim 一次能省下不少麻煩。