除了大家熟悉的選擇器與 DOM 方法,jQuery 還在 $ 上掛了一大批與選取無關的通用工具函式。它們處理的是陣列、物件、字串與型別判斷這類基礎工作,寫起來往往比原生寫法簡潔。以下逐一走過。
屬性對照:webkit(Chrome、傲游等)、mozilla(Firefox)、safari、opera、msie(IE、360、搜狗等),以及 version 回傳版本號。
$(function () {
if ($.browser.msie) { alert("IE浏覽器"); }
if ($.browser.webkit) { alert("webkit浏覽器"); }
if ($.browser.mozilla) { alert("mozilla浏覽器"); }
if ($.browser.safari) { alert("safari浏覽器"); }
if ($.browser.opera) { alert("opera浏覽器"); }
alert($.browser.version);
});
要提醒的是,$.browser 在 jQuery 1.9 中已被移除,取而代之的是 $.support。它判斷的是瀏覽器内核,而非使用者代理字串,本質上就不可靠,新專案應改用特性偵測。
W3C 盒子模型不含 padding 與 border,寬高只算內容本身;IE 盒子模型則把 padding 與 border 一起算進去。
$(function () {
if ($.support.boxModel) {
alert("W3C盒子模型!");
} else {
alert("IE盒子模型!");
}
});
這個判斷的依據其實是文件頭有沒有宣告 DOCTYPE。把 DOCTYPE 那幾行拿掉,瀏覽器會進入相容模式,就會得到 IE 盒子模型。
語法為 $.each(obj, fn(index, value))。它不只遍歷陣列,也能遍歷物件與 jQuery 集合。
var arr = [1, 2, 3, 4, 5];
$.each(arr, function (index, value) {
document.write(index + ":" + value + "<br/>");
});
// 輸出 0:1 1:2 2:3 3:4 4:5
var obj = { "張三": "23", "李四": 22, "王五": "21" };
$.each(obj, function (index, value) {
document.write(index + ":" + value + "<br/>");
});
// 輸出 張三:23 李四:22 王五:21
遍歷頁面元素:
$(function () {
$("p").each(function () {
$(this).css("background-color", "red");
});
// 以下寫法效果相同
// $.each($("p"), function () {
// $(this).css("background-color", "red");
// });
});
語法 $.grep(array, fn(value, index), [invert])。注意回呼參數順序是值在前、索引在後。第三個參數為 true 時會反轉結果。
var arr = [2, 5, 34, 22, 8];
var arr1 = $.grep(arr, function(value, index) {
return index <= 2 && value < 10;
});
document.write(arr1.join()); // 輸出 2,5
與 grep 不同,map 是拿回呼的回傳值組成新陣列,原陣列不受影響。
var arr = [2, 5, 34, 22, 8];
var arr1 = $.map(arr, function (value, index) {
if (value > 5 && index < 3) { return value - 10; }
});
document.write(arr.join() + "<br/>"); // 2,5,34,22,8
document.write(arr1.join()); // 24
var arr = [1, 2, 3, 4, 5]; alert($.inArray(4, arr)); // 3,找不到則回傳 -1
var str = " 你在他鄉還好嗎? ";
document.write("11" + $.trim(str) + "11"); // 11你在他鄉還好嗎?11
$.isArray(obj) 是否為陣列。
$.isFunction(obj) 是否為函式。
$.isEmptyObject(obj) 是否為空物件。
$.isPlainObject(obj) 是否為以 {} 或 new Object() 建立的純物件。
$.contains(container, contained) 是否為父子關係,注意參數必須是 DOM 物件而非 jQuery 物件。
var arr = [1, 2, 3, 2, 1];
document.write(jQuery.isArray(arr)); // true
document.write(jQuery.isArray("123")); // false
var obj1 = {};
var obj2 = { name: "張飛" };
var obj3 = new Object();
var obj4 = null;
alert($.isPlainObject(obj1)); // true
alert($.isPlainObject(obj3)); // true
alert($.isPlainObject(obj4)); // false
var man = { Name: "張飛", Age: 23 };
var str = $.param(man);
document.write(str); // Name=%E5%BC%A0%E9%A3%9E&Age=23
document.write(decodeURI(str)); // Name=張飛&Age=23
var arr1 = [1, 3, 5, 7, 9]; var arr2 = [2, 4, 6, 8, 10]; var arr3 = $.merge(arr1, arr2); document.write(arr3.join()); // 1,3,5,7,9,2,4,6,8,10
merge 會直接修改第一個陣列,第二個不受影響,這點要特別注意。
var man = { name: "張三", age: 23 };
var str = JSON.stringify(man);
var man1 = $.parseJSON(str);
document.write(man1.name + man1.age); // 張三23
jQuery 只提供了解析用的 parseJSON,序列化仍要仰賴原生的 JSON.stringify()。
$(function () {
var obj = {
name: "John",
test: function () {
alert(this.name);
$("#test").unbind("click", obj.test);
}
};
$("#test").click(jQuery.proxy(obj, "test"));
});
若直接把 obj.test 當回呼傳入,執行時 this 會變成被點擊的元素而非 obj。proxy() 解決的正是這個問題,作用等同於原生的 bind()。
var arr = [1, 2, 3, 2, 1]; jQuery.unique(arr); alert(arr.join()); // 3,2,1
var result = $.extend({}, {name:"Tom", age:21}, {name:"Jerry", sex:"Boy"});
alert(result.name); // Jerry
後者會覆蓋前者的同名屬性,這是最需要牢記的規則。第一個參數是目標物件,通常傳空物件以免污染既有資料。
省略目標參數時,該方法只接受一個 src,並把它合併到呼叫者身上:
$.extend({
hello: function(){ alert('hello'); }
});
$.hello(); // 等於把 hello 掛到 jQuery 全域物件上
也可以用它建立命名空間:
$.extend({ net: {} });
$.extend($.net, {
hello: function(){ alert('hello'); }
});
$.net.hello();
deep copy 的寫法是在第一個參數加上布林值:
extend(boolean, dest, src1, src2, src3...)
var result = $.extend(true, {},
{ name: "John", location: {city: "Boston", country: "USA"} },
{ last: "Resig", location: {state: "MA", country: "China"} }
);
alert(result.location.state); // MA
// 結果:{name:"John", last:"Resig",
// location:{city:"Boston", state:"MA", country:"China"}}
var result2 = $.extend(false, {},
{ name: "John", location: {city: "Boston", country: "USA"} },
{ last: "Resig", location: {state: "MA", country: "China"} }
);
alert(result2.location.city); // undefined
差別一目了然:淺拷貝時,後一個 location 會整包取代前一個,連 city 都一起消失;深拷貝才會把兩層的屬性逐一合併。