jQuery 提供一組靜態工具方法(jQuery.* 或 $.*)處理字符串、數組、對象,無需依賴 DOM 選擇器。本文整理高頻 API 與示例。
$.trim(' hello '); // 'hello' (ES5 String.prototype.trim 同樣可用)
$.trim('\t\n hello \r\f'); // 'hello' (處理所有空白字符)
var obj = {name: 'dog', count: 10};
$.param(obj); // "name=dog&count=10" (URL 編碼)
$.param({a: [1,2], b: 3}); // "a%5B%5D=1&a%5B%5D=2&b=3" (陣列編碼為 a[]=1&a[]=2)
$.isArray([]); // true
$.isArray({}); // false
$.isArray('str'); // false
$.isFunction(function(){}); // true
$.isFunction({}); // false
$.isFunction(null); // false
// 現代替代
Array.isArray([]); // 原生,更快
typeof fn === 'function'; // 原生
// 陣列
$.each([10,20,30], function(index, value) {
console.log(index, value); // 0 10, 1 20, 2 30
if (value > 15) return false; // 返回 false 中斷循環 (break)
});
// 對象
$.each({x:1, y:2}, function(key, value) {
console.log(key, value); // x 1, y 2
});
// 對比:$(selector).each() 僅遍歷 jQuery 對象集合
var divs = document.getElementsByTagName('div'); // HTMLCollection
var arr = $.makeArray(divs); // 真正的 Array
arr.reverse(); // 現在可以用數組方法
$('#container').html(arr);
var nums = [1,2,3,4,5];
var gt3 = $.grep(nums, function(v) { return v > 3; }); // [4,5]
var lte3 = $.grep(nums, function(v) { return v > 3; }, true); // [1,2,3] (invert=true 反轉)
var nums = [1,2,3,4];
var doubled = $.map(nums, function(v) { return v * 2; }); // [2,4,6,8]
// 可返回多個值展平
var pairs = $.map([1,2], function(v) { return [v, v*10]; }); // [1,10,2,20]
var a = [1,2,3], b = [4,5];
$.merge(a, b); // a 變為 [1,2,3,4,5] (修改第一個參數並返回)
console.log(a); // [1,2,3,4,5]
<a class="link" id="1"></a>
<a class="link link1" id="2"></a>
var $links = $('.link'); // [#1, #2]
var $first = $('.link1'); // [#2]
var merged = $.merge($links, $first); // [#1, #2, #2]
var unique = $.unique(merged); // [#1, #2] (僅 DOM 元素去重,基于元素唯一性)
注意: $.unique 僅支持 DOM 元素數組去重,不支持字符串/數字數組。
| jQuery | 原生 (ES5/ES6+) |
|---|---|
| $.trim(str) | str.trim() |
| $.param(obj) | new URLSearchParams(obj).toString() |
| $.isArray(arr) | Array.isArray(arr) |
| $.isFunction(fn) | typeof fn === 'function' |
| $.each(arr, fn) | arr.forEach(fn) / for...of |
| $.makeArray(coll) | Array.from(coll) / [...coll] |
| $.grep(arr, fn) | arr.filter(fn) |
| $.map(arr, fn) | arr.map(fn).flat() |
| $.merge(a,b) | a.push(...b) / [...a, ...b] |
| $.unique(arr) | [...new Set(arr)] (非 DOM 元素) |