DIV CSS 佈局教程網

jQuery each() 用法詳解:遍歷陣列、物件與 break/continue
編輯:JQuery特效代碼     

each() 幾乎是所有框架都會提供的工具函式,用來遍歷物件或陣列的屬性並逐一處理。jQuery 物件與 jQuery 本身都實作了這個方法——對 jQuery 物件而言,它只是把 each 簡單地委託出去:把自己當成第一個參數傳給 jQuery.each()。

換句話說,jQuery 提供的 each() 是對傳入物件的所有子元素逐一呼叫方法;而 jQuery 物件的 each() 則是對它內部的元素逐個呼叫。

核心實作

jQuery.prototype.each = function (fn, args) {
    return jQuery.each(this, fn, args);
};

jQuery.each(obj, fn, args) 有三個參數:要操作的物件 obj、要執行的函式 fn、以及傳給 fn 的參數 args。依 obj 的型別,行為分成兩種:

1. obj 是陣列——會對每個子元素呼叫 fn,直到某次呼叫回傳 false 為止。也就是說,可以在 fn 裡做條件判斷來提早結束迴圈。若提供了 args,fn 收到的參數就是 args;否則是「子元素索引、子元素本身」。

2. obj 不是陣列——與上者的最大差異是:fn 會被逐次呼叫,而且**不考慮回傳值**,也就是即使回傳 false 也不會中斷,所有屬性都會被處理一遍。

jQuery.each = function (obj, fn, args) {
    if (args) {
        if (obj.length == undefined) {
            for (var i in obj) fn.apply(obj, args);
        } else {
            for (var i = 0, ol = obj.length; i < ol; i++) {
                if (fn.apply(obj, args) === false) break;
            }
        }
    } else {
        if (obj.length == undefined) {
            for (var i in obj) fn.call(obj, i, obj);
        } else {
            for (var i = 0, ol = obj.length, val = obj[0];
                 i < ol && fn.call(val, i, val) !== false; val = obj[++i]) {}
        }
    }
    return obj;
};

要特別注意的是,fn 並不是用簡單的 fn(i, val) 呼叫,而是採用 fn.call(val, i, val) 或 fn.apply(obj, args)。這意味著在自己的 fn 實作裡,可以直接用 this 參照到陣列或物件的子元素。這是 jQuery 內部相當常見的寫法。

用實例來看

一個常見應用是表單送出前的批次檢查:

$("#submit").click(function () {
    try {
        $('#leftTbl tr').each(function (i) {
            var emailInput = $("#email_" + (1 + i));
            if (!re.test(emailInput.val())) {
                alert("請正確填寫 email");
                emailInput.focus();
                throw emailInput;
            } else {
                email = emailInput.val();
            }
        });
    } catch (e) {
        return false;
    }
    $("#pageform").submit();
});

這裡用 throw/catch 來中斷迴圈,也可以用計數器累加之後再判斷,兩種都行。

在 each 裡實作 break 與 continue

$('input').each(function () {
    if ($(this).val() == '') {
        // do something
        if (1 == 1) return false; // return false 等同 break,跳出迴圈
        else return true;         // return true 等同 continue,進入下一輪
    }
});

原理很簡單:jQuery 迭代每個元素後檢查回傳值,以此決定是否繼續下一輪。

幾個實際寫法

var arr = ["one", "two", "three", "four"];
$.each(arr, function () {
    alert(this);
});
// 依序輸出:one、two、three、four

var arr1 = [[1, 4, 3], [4, 6, 6], [7, 20, 9]];
$.each(arr1, function (i, item) {
    alert(item[0]);
});
// arr1 是二維陣列,item 代表每個一維陣列,item[0] 取其第一個值
// 輸出:1、4、7

var obj = { one: 1, two: 2, three: 3, four: 4 };
$.each(obj, function (key, val) {
    alert(obj[key]);
});
// 這招更強,能逐一走訪物件的每個屬性
// 輸出:1、2、3、4
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved