事件綁好之後想取消,該怎麼做?jQuery 提供了 bind()(綁定)、unbind()(移除)與 one()(只觸發一次)三個方法。理解它們的關係,能處理掉不少「事件重複觸發」的困擾。
<script type="text/javascript">
$(function () {
$('#btn').bind("click", function () {
$('#test').append("<p>綁定函數1</p>");
}).bind("click", function () {
$('#test').append("<p>綁定函數2</p>");
}).bind("click", function () {
$('#test').append("<p>綁定函數3</p>");
});
});
</script>
<body>
<button id="btn">Click Me</button>
<div id="test"></div>
</body>
點一次按鈕,三個 click 都會觸發,append() 因此在 div 末尾依序追加三段內容。這示範了一個重要觀念:同一元素同一事件可以綁多個處理器,且會全部執行。
順帶釐清一個常見混淆:append() 是在元素內部結尾追加內容,html() 則是取代整個內部內容;text() 與 html() 的差別在於後者會把字串中的標籤解析成 DOM,前者會當純文字處理。
<script type="text/javascript">
$(function () {
$('#btn').bind("click", function () {
$('#test').append("<p>綁定函數1</p>");
}).bind("click", function () {
$('#test').append("<p>綁定函數2</p>");
}).bind("click", function () {
$('#test').append("<p>綁定函數3</p>");
});
$('#delAll').click(function () {
$('#btn').unbind("click"); // 一次移除 btn 上所有 click 處理器
});
});
</script>
$('#btn').unbind("click") 會移除該元素上全部的 click 處理器。值得一提的是,它對 .click(function(){}) 這種簡寫同樣有效——因為 bind("click", fn) 與 click(fn) 本質上等價。
若要保留其他處理器,只刪掉其中一個,必須在綁定時幫函式命名,再把名字當第二個參數傳入:
<script type="text/javascript">
$(function () {
$('#btn').bind("click", myFun1 = function () {
$('#test').append("<p>綁定函數1</p>");
}).bind("click", myFun2 = function () {
$('#test').append("<p>綁定函數2</p>");
}).bind("click", myFun3 = function () {
$('#test').append("<p>綁定函數3</p>");
});
$('#delTwo').click(function () {
$('#btn').unbind("click", myFun2); // 只移除 myFun2
});
});
</script>
執行後只有 myFun2 被移除,另外兩個 click 照常運作。
<script type="text/javascript">
$(function () {
$('#btn').one("click", function () {
$('#test').append("<p>綁定函數1</p>");
}).one("click", function () {
$('#test').append("<p>綁定函數2</p>");
}).one("click", function () {
$('#test').append("<p>綁定函數3</p>");
});
});
</script>
點擊後三個函式各執行一次,之後再點就不會有任何反應。這在初始化場景很實用——例如「首次互動時載入資料」、「第一次點擊時顯示教學提示」。
bind / unbind 已在 jQuery 3.0 中移除,新專案請改用 on 與 off:
// 綁定
$('#btn').on('click', handler);
// 只綁一次(取代 one)
$('#btn').one('click', handler); // one 仍存在,可直接用
// 或用 off 自我解除
$('#btn').on('click', function handler() {
// ...
$(this).off('click', handler);
});
// 移除全部 click
$('#btn').off('click');
// 移除特定函式
$('#btn').off('click', myFun2);
// 用命名空間精準移除,不必記函式名稱
$('#btn').on('click.myPlugin', handler);
$('#btn').off('.myPlugin');
命名空間是這裡最值得學的技巧。當同一元素被多個模組各綁一個 click 時,用 off('click') 會把別人的也一起清掉。加上命名空間後,每個模組只移除自己掛的那一份,互不干擾。這在大型專案中幾乎是必需品。
另一個關鍵差異:事件委派。on 支援委派語法,bind 不支援:
// 對未來動態加入的子元素也有效
$('#list').on('click', 'li', function () { ... });
這是全面改用 on 最實際的理由。