map() 與 each() 都用來遍歷集合,但它們的返回值與適用場合並不相同。以下用範例把兩者講清楚。
語法:map(callback)
為包裝集中的每個元素呼叫回呼函數,並把回傳值收集成一個 jQuery 物件實例。callback 參數為必填函數。
例如把頁面上所有 div 的 id 收集成陣列:
var iDs = $("div").map(function(){
return (this.id == undefined) ? null : this.id;
}).get();
注意最後的 .get() —— 它會把 jQuery 物件轉成真正的 JavaScript 陣列。若回呼中回傳 null,該項會被排除。
再看一組 checkbox:
<form method="post" action="">
<fieldset>
<div><label for="two">2</label><input type="checkbox" value="2" id="two" name="number[]"></div>
<div><label for="four">4</label><input type="checkbox" value="4" id="four" name="number[]"></div>
<div><label for="six">6</label><input type="checkbox" value="6" id="six" name="number[]"></div>
<div><label for="eight">8</label><input type="text" value="8" id="eight" name="number[]"></div>
</fieldset>
</form>
想要一段以逗號分隔的 id 清單:
$(':checkbox').map(function(){
return this.id;
}).get().join();
結果就是字串 "two,four,six"。在回呼當中,this 指向每次迭代的當前 DOM 元素。
語法:each(iterator)
遍歷匹配集中的所有元素,為每個元素呼叫傳入的迭代函數。iterator 為必填回呼。
each() 也能用來遍歷 JavaScript 陣列甚至單一物件:
$([a, b, c, d]).each(function(){
alert(this);
})
這段程式會為陣列中每個元素呼叫迭代函數,函數內的 this 指向該項。
每次回呼執行時,會傳入當前迴圈次數作為參數(從 0 開始)。更重要的是,回呼是在「當前 DOM 元素為語境」的前提下觸發,因此 this 永遠指向該元素。
例如頁面上有一個簡單的無序列表:
<ul>
<li>foo</li>
<li>bar</li>
</ul>
可以這樣選取並迭代:
$("li").each(function(index){
console.log(index + ": " + $(this).text());
});
輸出:
0: foo
1: bar
map() 主要用來遍歷並「轉換」成新集合,適合需要收集結果的場景;each() 主要用於遍歷 jQuery 物件並執行副作用,例如設定樣式、觸發事件。
關鍵差異在返回值:each() 回傳原本的集合,不會建立新陣列;map() 則會產生一個新陣列。因此在不需要新集合時改用 map(),反而可能造成不必要的記憶體配置。