前面談過原生 JavaScript 處理事件的麻煩:IE 與標準 DOM 的註冊方式不同,多個監聽函式的執行順序也不一致。jQuery 在這件事上做了大量相容性處理,讓開發者只需面對一組簡潔的 API。本文分三部分:綁定、移除,以及事件物件的傳遞。
bind() 對應 IE 的 attachEvent() 與標準 DOM 的 addEventListener()。以下對同一個 img 綁上三個 click 監聽:
<script type="text/javascript">
$(function () {
$("img")
.bind("click", function () {
$("#show").append("<div>點擊事件 1</div>");
})
.bind("click", function () {
$("#show").append("<div>點擊事件 2</div>");
})
.bind("click", function () {
$("#show").append("<div>點擊事件 3</div>");
});
});
</script>
<img src="11.jpg">
<div id="show"></div>
通用語法為:
bind(eventType [, data], listener)
eventType 是事件類型,可用 blur、focus、load、resize、scroll、unload、click、dblclick、mousedown、mouseup、mouseover、mouseout、mouseenter、mouseleave、change、select、submit、keydown、keypress、keyup、error 等。
data 是可選參數,用來傳遞額外資料給監聽函式。
listener 是事件監聽函式,上例使用匿名函式。
若多個事件要共用同一個監聽函式,可以在 eventType 中以空白分隔一次寫出:
$(function () {
$("p").bind("mouseenter mouseleave", function () {
$(this).toggleClass("over");
});
});
另外,常見事件類型可以直接用「事件名稱作為方法名」的簡寫,參數就是監聽函式:
$("p").click(function () {
// click 事件監聽
});
可用的名稱包含 blur、focus、load、resize、scroll、unload、click、dblclick、mousedown、mouseup、mousemove、mouseover、mouseout、change、select、submit、keydown、keypress、keyup、error 等。
除了 bind(),jQuery 還提供 one()。它綁定的函式在觸發一次後會自動解除,之後不再生效:
// 先建立 10 個 div
for (var i = 0; i < 10; i++) {
$(document.body).append($("<div>Click<br>Me!</div>"));
}
var iCounter = 1;
// 為每個 div 綁上只會執行一次的 click
$("div").one("click", function () {
$(this).css({
background: "#8f0000",
color: "#FFFFFF"
}).html("Clicked!<br>" + (iCounter++));
});
這個模式很適合用於「引導提示」:第一次點擊時顯示說明或教學,之後就不再打擾使用者。
unbind() 負責移除,兩個參數都是可選的,不帶參數時會清除該元素上的所有事件:
$("p").unbind("click"); // 移除 p 的所有 click 事件
$("div").unbind(); // 移除 div 的所有事件
若想只移除某個特定的函式,必須使用第二個參數:
var myFunc = function () {
// 監聽函式內容
};
$("p").bind("click", myFunc);
$("p").unbind("click", myFunc);
以下範例示範如何做到「只解除其中一個」:
<script type="text/javascript">
$(function () {
var fnMyFunc1; // 先宣告函式變數
$("img")
.bind("click", fnMyFunc1 = function () { // 綁定時指派給變數
$("#show").append("<div>點擊事件 1</div>");
})
.bind("click", function () {
$("#show").append("<div>點擊事件 2</div>");
})
.bind("click", function () {
$("#show").append("<div>點擊事件 3</div>");
});
$("input[type=button]").click(function () {
$("img").unbind("click", fnMyFunc1); // 只移除第一個
});
});
</script>
<img src="11.jpg">
<input type="button" value="移除事件 1">
<div id="show"></div>
關鍵在於「函式要有名字可指認」。匿名函式雖然方便,但一旦傳進 bind() 就再也取不到參照,也就無法單獨移除。這是為什麼在需要動態解除監聽時,務必先把函式存進變數。
事件物件在不同瀏覽器間的差異相當多,而 jQuery 為開發者統一了它們。事件物件會作為唯一參數傳給監聽函式:
<script type="text/javascript">
$(function () {
$("p").bind("click", function (e) { // 接收事件物件 e
var sPosPage = "(" + e.pageX + "," + e.pageY + ")";
var sPosScreen = "(" + e.screenX + "," + e.screenY + ")";
$("span").html("<br>Page: " + sPosPage + "<br>Screen: " + sPosScreen);
});
});
</script>
<p>點擊此處</p>
<span></span>
這段程式碼取得了滑鼠觸發點的兩組座標:pageX/pageY 是相對於文件的座標(含捲動量),screenX/screenY 則是相對於整個螢幕的座標。實作浮動提示、拖曳時,通常用前者。
altKey:按下 alt 鍵為 true。
ctrlKey:按下 ctrl 鍵為 true。
shiftKey:按下 shift 鍵為 true。
keyCode:keydown 與 keyup 事件中回傳按鍵值(不分大小寫,a 與 A 皆為 65)。
pageX、pageY:滑鼠相對於文件的位置,不含工具列、捲軸等。
screenX、screenY:滑鼠相對於整個螢幕的位置。
relateTarget:滑鼠事件中,指針進入或離開的元素。
target:引起事件的元素或物件。
type:事件名稱,如 click、mouseover。
which:鍵盤事件中為按鍵的字符編碼;滑鼠事件中代表按鍵(1 左鍵、2 中鍵、3 右鍵)。
stopPropagation():阻止事件向上冒泡。
preventDefault():阻止事件的預設行為。
這套 API 寫於 jQuery 1.x 時代。從 jQuery 1.7 起,官方建議改用 on() 與 off() 取代 bind()/unbind(),主要好處是支援事件委派——可以為動態加入的元素自動生效,例如:
$(document).on("click", ".dynamic-btn", function () {
// 即使按鈕是稍後才產生的,這裡也會被觸發
});
而 jQuery 3.0 已正式移除 bind()、unbind()、delegate()、undelegate() 等方法,因此新專案應一律使用 on()/off()。不過理解 bind 與 unbind 的模型,仍有助於讀懂大量既有的老程式碼。