同一個元素上綁了五、六個事件,臨時只想解除其中幾個,用 unbind 逐一指定既冗長又容易漏。jQuery 的事件命名空間正是為此而生:綁定時加上自訂標籤,解除時用標籤一次處理。

<script type="text/javascript" src="js/jquery-1.3.2.js"></script>
<script type="text/javascript">
$(function () {
// 帶 .plugin 命名空間
$("div").bind("click.plugin", function () {
$("body").append("<p>click 事件</p>");
});
$("div").bind("mouseover.plugin", function () {
$("body").append("<p>mouseover 事件</p>");
});
// 沒有命名空間
$("div").bind("dblclick", function () {
$("body").append("<p>dblclick 事件</p>");
});
// 一次移除所有屬於 plugin 命名空間的綁定
$("#but").click(function () {
alert("remove");
$("div").unbind(".plugin");
});
});
</script>
<div style="border: 1px solid red; height: 100px; width: 300px;">
已經綁定了 click、mouseover、dblclick 事件的層
</div>
<input id="but" type="button" value="remove" />
bind("click.plugin", fn) 中的 .plugin 只是一個附加標籤,並不會改變事件型別,click 依然是一般點擊事件。它的價值出現在解除階段:unbind(".plugin") 會把所有掛了這個標籤的處理器一次清掉,而不影響 dblclick。
執行順序上,點 remove 按鈕後,click 與 mouseover 都不再觸發,dblclick 則照常運作,這正好驗證了標籤的隔離效果。
jQuery 1.7 之後,bind/unbind 已被 on/off 取代,命名空間語法完整保留:
$("div").on("click.plugin mouseover.plugin", function (e) {
$("body").append("<p>" + e.type + " 事件</p>");
});
$("div").on("dblclick", function () {
$("body").append("<p>dblclick 事件</p>");
});
// 一次解除 plugin 命名空間
$("#but").on("click", function () {
$("div").off(".plugin");
});
若專案已不用 jQuery,原生 DOM 的 addEventListener 沒有命名空間機制,替代做法是保存回呼函式參照,再用 removeEventListener(type, fn) 逐一移除;或使用 AbortController 搭配 signal 選項,一次 abort 就能取消該 controller 下的所有監聽器,效果與命名空間相近。