事件處理函式掛上去之後,有時需要「事後取消」。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 處理函式會依序執行,div 裡被追加三段內容。這說明同一元素、同一事件可以掛多個處理函式,而且會全部跑。
順帶釐清 append() 的行為:它把內容追加到被選元素的尾端(仍在元素內部),與 html() 不同——後者是把整個元素的內容換掉。而 text() 與 html() 的差別在於:html() 傳入的 HTML 會被正確解析成標籤,text() 則一律當成純字串。
<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") 會取消元素 btn 底下所有 click 事件。它不只對 bind() 有效,對 click() 這種簡寫同樣有效——某個角度看,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>
unbind() 的第二個參數就是處理函式的名稱,執行後只有 myFun2 被移除,另外兩個照常運作。
<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 一樣,差別是每個處理函式觸發一次後就自動解除綁定。點第一次三段都會執行,之後再點就不會有任何反應。適合做「首次進入引導」、「第一次點擊才載入資料」這類只需要一次的行為。
從 jQuery 1.7 起,官方推薦改用 on() 與 off(),bind()/unbind() 已被視為舊寫法(在 jQuery 4 中移除)。對應關係很直接:bind("click", fn) → on("click", fn),unbind("click") → off("click"),one() 則仍舊可用。新專案建議直接採用 on/off,並善用它的委派語法 $(document).on("click", ".btn", fn) 來處理動態加入的元素。