click 是最常用的事件方法,但它的 data 參數常常被忽略。這個參數能解決一個很實際的問題:如何在事件處理函式中取得外部的上下文資料。
click(fn) — 在每個符合的元素上綁定 click 處理函式。這個函式會執行所有綁定到 click 的處理器。
click([data], fn) — 同上,但可額外傳入 data,供函式處理時使用。
參數 fn 是綁定的處理函式。參數 data 是會作為 event.data 屬性傳給事件物件的額外資料,這個用法從 jQuery 1.4.3 起支援。
// 觸發頁面上所有段落的點擊事件
$("p").click();
// 點擊段落後將其隱藏
$("p").click(function () { $(this).hide(); });
官方手冊對 data 參數的說明一向簡短,很多資料都沒講清楚它實際能做什麼。簡單說:data 會被掛到 event 物件的 data 屬性上,讓你在處理函式裡讀取。
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
<title>JQuery [data] 參數使用說明</title>
<script src="jquery-1.8.3.min.js" type="text/javascript"></script>
<script type="text/javascript">
$(function(){
var message = "把該信息傳遞給Fn函數";
$(".txt").click({msg: message}, function(event){
$("#idTip").show().html(event.data.msg); // 透過 event.data 取出
});
});
</script>
</head>
<body>
<input class="txt">
<div id="idTip"></div>
</body>
</html>
若不用 data 參數,要在事件處理中取得外部變數,一般得靠閉包。閉包在單一元素上沒問題,但如果是迴圈中為多個元素綁定,閉包會共享同一個變數參考,導致所有元素都拿到最後一次迴圈的值——這是經典的陷阱。
// 有問題的寫法:所有按鈕都會顯示 "3"
for (var i = 0; i < 3; i++) {
$("#btn" + i).click(function(){
alert(i);
});
}
// 用 data 參數解決
for (var i = 0; i < 3; i++) {
$("#btn" + i).click({index: i}, function(event){
alert(event.data.index); // 各自拿到正確的值
});
}
data 參數的值會在綁定當下就被固定下來,因此不受後續變數變動影響。這是它在迴圈綁定場景中的關鍵價值。