初學 jQuery 時,最容易被這兩個長得很像的 API 搞糊塗:$.each() 與 $().each()。簡單一句話總結:前者是通用的迭代工具函式,後者是 jQuery 物件專用的成員方法。
它掛在 jQuery 命名空間下,可以近似地遍歷任何物件與陣列,而不侷限於 jQuery 物件。回呼函式固定接收兩個參數:第一個是索引(陣列)或鍵名(物件),第二個是對應的值。
它掛在 jQuery 原型(jQuery.fn)上,只能對 jQuery 物件呼叫,用來遍歷選到的 DOM 元素集合。在回呼裡,this 會指向目前的原生 DOM 元素,因此若要使用 jQuery 方法,必須先包成 $(this)。
<script type="text/javascript">
var json = {
'name': 'tom',
'school': 'middle school',
'grade': 95
};
// 遍歷物件:key 為屬性名稱,value 為屬性值
$.each(json, function(key, value){
alert(key + ' = ' + value);
});
// 遍歷陣列:key 為索引,value 為元素
var arr = ['a', 'b', 'c'];
$.each(arr, function(index, item){
alert(index + ' -> ' + item);
});
</script>
$('ul li').each(function(index){
// this 是原生 DOM 元素,若要呼叫 jQuery 方法需重新包裝
console.log(index, $(this).text());
});
兩者的中斷方式一致:在回呼中 return false; 等同 break,return true; 等同 continue,其他回傳值則會被忽略。這個特性在做「找到第一個符合條件的元素就停止」這類需求時特別好用。