DIV CSS 佈局教程網

jQuery 實用工具函式 17 例:從 trim 到 getScript
編輯:JQuery特效代碼     

除了針對選到的元素操作,jQuery 還提供一批不必選元素就能直接呼叫的工具函式(utility)。以下依實際使用頻率整理,每項都附可直接複製的範例。

1. 修剪字串

$('#id').val($.trim($('#someid').val()));

表單送出前清掉頭尾空白,是最常見的用途。(ES5 之後原生的 String.prototype.trim() 已是標準,新專案可直接用。)

2. 遍歷集合

傳統寫法:

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) { });

3. 篩選陣列:$.grep

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'; });

4. 轉換陣列:$.map

// 每個元素加 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 做「轉換兼過濾」的關鍵特性。

5. 找索引:$.inArray

var index = $.inArray(2, [1, 2, 3]);   // 1

6. 轉成陣列:$.makeArray

<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 這類陣列方法,轉一次就能用。

7. 去重:$.unique

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

8. 合併陣列:$.merge

var a1 = [1, 2];
var a2 = [2, 3];
$.merge(a1, a2);
console.log(a1);   // [1, 2, 2, 3]

注意它不去重,且會直接修改第一個陣列。

9. 序列化成查詢字串:$.param

$(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

10. 一組型別判斷函式

$.isArray(o) 判斷是否為陣列(類陣列的 jQuery 物件會回傳 false);$.isEmptyObject(o) 判斷物件是否沒有任何屬性;$.isFunction(o) 判斷是否為函式;$.isPlainObject(o) 判斷是否由 {} 或 new Object() 建立;$.isXMLDoc(node) 判斷是否為 XML 文件或其節點。

11. 判斷包含關係:$.contains

$.contains(document.documentElement, document.body);   // true
$.contains(document.body, document.documentElement);   // false

12. 在元素上存資料:$.data

var div = $("div")[0];
jQuery.data(div, "test", { first: 16, last: 'pizza' });
jQuery.data(div, "test").first;

13. 移除資料:$.removeData

var div = $("div")[0];
jQuery.data(div, "test1", "VALUE-1");
jQuery.removeData(div, "test1");

14. 綁定函式的 this:$.proxy

$(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 可完全取代它。)

15. 解析 JSON:$.parseJSON

var obj = jQuery.parseJSON('{ "name": "John" }');
alert(obj.name === "John");

16. 在全域上下文求值:$.globalEval

function test() {
    jQuery.globalEval("var newVar = true;");
}
test();

17. 動態載入腳本:$.getScript

$.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 取代,但了解它們的行為仍有助於讀懂既有程式碼。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved