除了針對選到的元素操作,jQuery 還提供一批不必選元素就能直接呼叫的工具函式(utility)。以下依實際使用頻率整理,每項都附可直接複製的範例。
$('#id').val($.trim($('#someid').val()));
表單送出前清掉頭尾空白,是最常見的用途。(ES5 之後原生的 String.prototype.trim() 已是標準,新專案可直接用。)
傳統寫法:
var anArray = ['one', 'two'];
for (var n = 0; n < anArray.length; n++) { }
var anObject = { one: 1, two: 2 };
for (var p in anObject) { }
用 $.each() 可以統一寫法:
$.each(anArray, function (n, value) { });
$.each(anObject, function (name, value) { });
var arr = [1, 2, 3, 4, 5, 6];
arr = $.grep(arr, function (val, index) { return val > 3; });
console.log(arr); // 4 5 6
第三個參數 inv 是「反轉」開關。設為 true 時,會保留不符合條件的元素:
arr = $.grep(arr, function (val) { return val > 3; }, true);
console.log(arr); // 1 2 3
物件陣列也一樣好用:
var arr = [
{ first: "Jeffrey", last: 'Way' },
{ first: 'Allison', last: 'Way' },
{ first: 'John', last: 'Doe' },
{ first: 'Thomas', last: 'Way' }
];
arr = $.grep(arr, function (obj) { return obj.last === 'Way'; });
// 每個元素加 1
var oneBased = $.map([0, 1, 2, 3, 4], function (value) { return value + 1; });
// 字串陣列轉數字,非數字則剔除
var strings = ['1', '2', '3', '4', 'S', '6'];
var values = $.map(strings, function (value) {
var result = new Number(value);
return isNaN(result) ? null : result;
});
// 回傳陣列時會被合併進結果
var chars = $.map(['this', 'that'], function (value) { return value.split(''); });
回傳 null 或 undefined 的元素會被跳過,這是 map 做「轉換兼過濾」的關鍵特性。
var index = $.inArray(2, [1, 2, 3]); // 1
<div>First</div>
<div>Second</div>
<div>Third</div>
<div>Fourth</div>
<script>
var elems = document.getElementsByTagName("div");
var arr = jQuery.makeArray(elems);
arr.reverse();
$(arr).appendTo(document.body);
</script>
NodeList 是類陣列物件,沒有 reverse 這類陣列方法,轉一次就能用。
var divs = $("div").get(); // 6 個 div
divs = divs.concat($(".dup").get()); // 併入 3 個 → 9 個
alert(divs.length); // 9
divs = jQuery.unique(divs);
alert(divs.length); // 6
var a1 = [1, 2]; var a2 = [2, 3]; $.merge(a1, a2); console.log(a1); // [1, 2, 2, 3]
注意它不去重,且會直接修改第一個陣列。
$(document).ready(function () {
var personObj = new Object();
personObj.firstname = "John";
personObj.lastname = "Doe";
personObj.age = 50;
personObj.eyecolor = "blue";
$("button").click(function () {
$("div").text($.param(personObj));
});
});
結果:firstname=John&lastname=Doe&age=50&eyecolor=blue
$.isArray(o) 判斷是否為陣列(類陣列的 jQuery 物件會回傳 false);$.isEmptyObject(o) 判斷物件是否沒有任何屬性;$.isFunction(o) 判斷是否為函式;$.isPlainObject(o) 判斷是否由 {} 或 new Object() 建立;$.isXMLDoc(node) 判斷是否為 XML 文件或其節點。
$.contains(document.documentElement, document.body); // true $.contains(document.body, document.documentElement); // false
var div = $("div")[0];
jQuery.data(div, "test", { first: 16, last: 'pizza' });
jQuery.data(div, "test").first;
var div = $("div")[0];
jQuery.data(div, "test1", "VALUE-1");
jQuery.removeData(div, "test1");
$(document).ready(function () {
var objPerson = {
name: "John Doe",
age: 32,
test: function () {
$("p").after("Name: " + this.name + "<br> Age: " + this.age);
}
};
$("button").click($.proxy(objPerson, "test"));
});
點擊按鈕時執行的是 test 方法,但 this 被固定為 objPerson。(ES5 的 Function.prototype.bind 可完全取代它。)
var obj = jQuery.parseJSON('{ "name": "John" }');
alert(obj.name === "John");
function test() {
jQuery.globalEval("var newVar = true;");
}
test();
$.getScript("ajax/test.js", function (data, textStatus, jqxhr) {
console.log(data); // 回傳的內容
console.log(textStatus); // success
console.log(jqxhr.status); // 200
});
$.extend(true, {}, a, b)——第一個參數設為 true 時會做深層合併,這在處理巢狀的設定物件時是必需品,否則子物件會被整個覆蓋。
$.now()——回傳目前時間戳,比寫 new Date().getTime() 簡短。
$.noop——一個空函式,需要佔位回呼時用它比寫 function(){} 更能表達意圖。
這批函式在 jQuery 3 中有些已被標記為 deprecated(例如 $.isArray、$.isFunction、$.trim),官方建議改用原生寫法。新專案若已全面採用 ES6 以上語法,這些工具多半都能由原生 API 取代,但了解它們的行為仍有助於讀懂既有程式碼。