在迴圈中為元素綁定事件,是 JavaScript 面試與實務中最經典的陷阱之一。這個範例用同一個需求,示範四種寫法的實際差異。
<html>
<head>
<title>迴圈綁定事件</title>
<script type="text/javascript" src="https://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script>
</head>
<body>
<script type="text/javascript">
$(document).ready(function () {
var array = [0, 1, 2, 3];
// 寫法 1(錯誤)
/*
for (var index in array) {
$("#btn" + index).click(function() {
var item = array[index];
alert(item);
});
}
// 無論點哪個按鈕都彈出 3。因為 function(){} 不會被立即解析,直到點擊時才執行,此時 index 已經是 3。
*/
// 寫法 2(立即執行)
/*
for (var index in array) {
$("#btn" + index).click(function(i) {
var item = array[i];
alert(item);
}(index));
}
// 頁面載入時就連續彈出 0、1、2、3。因為 function(){}(index) 被立即執行,遇到 alert 就彈出去了。
*/
// 寫法 3(IIFE 回傳函式,正確)
/*
for (var index in array) {
$("#btn" + index).click(function (i) {
return function () {
var item = array[i];
alert(item);
};
}(index));
}
// 點 btn0 彈 0,點 btn1 彈 1……
// 1. function(i){}(index) 立即執行,i 依序收到 0、1、2、3
// 2. 內部不直接 alert,而是回傳一個函式,把執行時機延後到點擊
*/
// 寫法 4(event.data,推薦)
for (var index in array) {
$("#btn" + index).bind("click", { index: index }, clickHandler);
}
function clickHandler(event) {
var index = event.data.index;
var item = array[index];
alert(item);
}
// 點 btn0 彈 0,點 btn1 彈 1……
// 利用 event.data:index 在綁定當時就被存入事件物件,觸發時自然取得到。
});
</script>
<input type="button" id="btn0" value="btn0" />
<input type="button" id="btn1" value="btn1" />
<input type="button" id="btn2" value="btn2" />
<input type="button" id="btn3" value="btn3" />
</body>
</html>
寫法 1 之所以全部彈出 3,根源是 var 宣告的變數具有函式作用域,整個迴圈共用同一個 index。迴圈結束後 index 的值是 3,而 click 的處理函式直到使用者點擊時才執行,那時讀到的自然是 3。
寫法 2 把 (index) 加在後面,函式立刻被呼叫,所以頁面一載入就連續 alert 四次——這顯然不是我們要的。它的錯誤在於混淆了「註冊處理函式」與「執行處理函式」。
寫法 3 是經典解法:外層的 IIFE 立即執行,為每次迭代建立一個獨立作用域,把當時的 index 值以參數 i 的形式凍結在其中;內層則回傳一個函式作為真正的處理器,把執行時機延後到點擊發生。兩層缺一不可。
寫法 4 更乾淨。jQuery 的 bind()(與 on())第二個參數可以傳入一組資料,這組資料會被掛到事件物件上。由於 index 在綁定當時就寫進去了,觸發時從 event.data 讀回即可,完全不必依賴閉包技巧,也不必為每次迭代建立匿名函式。
ES6 的 let 具有區塊作用域,每次迴圈迭代都會產生一個獨立的 bindings,問題自動消失:
array.forEach((item, index) => {
$("#btn" + index).on("click", () => alert(item));
});
或用事件委派,只綁一個監聽器,效率更好也不受元素數量影響:
$(document).on("click", "input[id^='btn']", function(){
var index = this.id.replace("btn", "");
alert(array[index]);
});
事件委派還有一個附帶好處:動態新增的按鈕也會自動生效,不必重新綁定。這在列表會增刪的場合特別有用。
順帶一提,範例中的 for...in 並不適合走訪陣列——它走訪的是可列舉的屬性名稱而非索引,且順序不保證,若有人為 Array.prototype 擴充方法還會把它們一起列出來。走訪陣列請用 forEach、map 或單純的 for 迴圈。