一、摘要
事件是腳本編程的靈魂,所以這一章也是整個 jQuery 學習過程中的重點。本文詳細說明 jQuery 的事件處理機制,以及它所提供的格式化事件物件。
二、前言
這是本系列到目前為止篇幅最多的一篇,可見其分量。事件處理的觀念一旦清楚,後續的 Ajax、動畫、插件開發都會順暢許多。文中盡量多舉例,文中提到的 API 有些我自己也未必用過,若發現錯誤还请不吝指正。
三、事件與事件物件
先看我們最常使用的兩種添加事件方式:
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="https://www.w3.org/1999/xhtml">
<head>
<title>javascript中的事件</title>
<script type="text/javascript" src="scripts/jquery-1.3.2.js"></script>
<script type="text/javascript">
$(function() {
document.getElementById("testDiv2").onclick = showMsg;
})
function showMsg(event) {
alert("!!!");
}
</script>
</head>
<body>
<div id="testDiv1" onclick="showMsg();">單擊事件 1</div>
<div id="testDiv2">單擊事件 2</div>
</body>
</html>
為 testDiv2 添加 onclick 的方式是修改 DOM 屬性:
document.getElementById("testDiv2").onclick = showMsg;
它等效於:
<div id="testDiv1" onclick="alert('!!!');">單擊事件 1</div>
兩者效果相同,但並不等效。我們常用的修改元素屬性添加事件的方式,實際上是建立了一個匿名函式:
document.getElementById("testDiv1").onclick = function(event) {
alert("!!!");
};
這個匿名函式的簽名與我們手寫的 showMsg 相同,所以可以直接把 showMsg 賦值給 onclick。
這種方式的兩個弊端
1. 只能為一個事件綁定一個處理函式。使用 = 賦值會把先前綁定的所有處理函式全部沖掉。
2. 取得事件物件的方式在跨瀏覽器時不一致。
IE 中,事件物件是 window 物件的一個屬性:
obj.onclick = function() {
var oEvent = window.event;
}
在 DOM 標準中,事件物件作為唯一參數傳給處理函式:
obj.onclick = function(oEvent) {
// 也可寫成 arguments[0]
}
目前遵循 DOM 標準的瀏覽器有 Firefox、Safari、Opera、IE7 以上等。
3. 添加多播委託的函式在不同瀏覽器中寫法不同。
//統一的為物件添加多播事件委託的方法
scriptHelper.prototype.addEventListener = function(oTarget, sEventType, fnHandler) {
if( oTarget.addEventListener ) {
oTarget.addEventListener( sEventType, fnHandler, false )
} else if( oTarget.attachEvent ) {
oTarget.attachEvent( "on" + sEventType, fnHandler);
}
}
所以我們應該屏棄 <div onclick="..."> 這種直接修改元素屬性的方式,改用多播委託為同一事件綁定多個處理函式。例如為 document 的單擊事件追加一個關閉彈出層的方法時,用多播就不會影響既有的處理函式。
四、jQuery 中的事件
有了 jQuery,我們不必自己實作多播委託的函式。最常使用的是 bind():
$("#testDiv4").bind("click", showMsg);
使用 jQuery 事件處理函式的好處
1. 添加的是多播事件委託。不會覆蓋既有的處理函式:
$("#testDiv4").bind("click", function(event) { alert("one"); });
$("#testDiv4").bind("click", function(event) { alert("two"); });
單擊時會依序提示 one 與 two。
2. 統一了事件名稱。原生寫法裡 IE 的事件名稱前面要加 "on",用 bind() 則不必區分,jQuery 內部已代為處理。
3. 讓 HTML 只負責「顯示」。目前的趨勢是把結構、樣式、行為三者切乾淨:HTML 管內容、CSS 管樣式、腳本管行為。使用 jQuery 的事件函式可以避免在標籤上直接寫 onclick。
基礎事件函式速查
bind( type, [data], fn )——為每個匹配元素的特定事件綁定處理函式。
$("p").bind("click", function(){
alert( $(this).text() );
});
one( type, [data], fn )——同上,但只執行一次。
$("p").one("click", function(){
alert( $(this).text() );
});
trigger( event, [data] )——在每個匹配元素上觸發某類事件。這個函式也會導致瀏覽器同名的預設行為;例如觸發 'submit' 會真的送出表單。若要阻止,讓處理函式回傳 false。你也可以觸發自訂事件,並為事件傳遞參數:
$("p").click( function (event, a, b) {
// 一般點擊時 a、b 為 undefined
} ).trigger("click", ["foo", "bar"]);
triggerHandler( event, [data] )——只觸發綁定的處理函式,不執行瀏覽器預設動作。
$("#old").click(function(){
$("input").trigger("focus");
});
$("#new").click(function(){
$("input").triggerHandler("focus");
});
$("input").focus(function(){
$("<span>Focused!</span>").appendTo("body").fadeOut(1000);
});
unbind( type, fn )——bind 的反向操作。不帶參數則刪除所有綁定;只給型別則刪除該型別全部;再給函式則只刪除該特定處理函式。
$("p").unbind()
$("p").unbind( "click" )
var foo = function () {
// 處理某個事件的程式碼
};
$("p").bind("click", foo);
$("p").unbind("click", foo);
五、常用事件函式舉例
1. bind 的 data 參數
注意方法簽名上的 data 參數,可以在事件處理之前傳遞附加資料:
function handler(event) {
alert(event.data.foo);
}
$("p").bind("click", {foo: "bar"}, handler)
data 參數也要透過 event.data 存取。為何需要它?因為我們經常需要在事件處理中,依據事件來源的某些資料做特殊處理。
做法一:使用自訂元素屬性存放資料。
<div id="testDiv5" customer="customer data 1">獲取自訂資料-1</div>
$("#testDiv5").bind("click", function(event) {
alert($(event.target).attr("customer"));
});

做法二:用腳本把資料傳給處理函式。
<div id="testDiv6">獲取自訂資料-2</div>
$("#testDiv6").bind("click", { customer: "customer data 2" }, function(event) {
alert(event.data.customer)
});

做法一便於存放與查找資料,但自訂屬性無法通過 W3C 驗證。做法二必須自己想辦法存放資料,並制定規則查找指定元素的資料。從開發者角度看做法一更直觀,但缺點較明顯,如何取捨請自行決定。(補充:HTML5 之後已有 data-* 屬性正式標準化,做法一的疑慮至此消解,$(el).data('customer') 就是今日的標準答案。)
2. trigger 與 triggerHandler 的差別
有時我們希望在程式中主動觸發已綁定的事件。兩者的主要差別是:trigger 會觸發瀏覽器預設動作,triggerHandler 不會。
<button id="old"> .trigger("focus")</button>
<button id="new"> .triggerHandler("focus")</button><br />
<input type="text" value="To Be Focused" />
<div id="divResult"></div>
單擊「.trigger」按鈕時,Focused! 被呼叫了兩次,並且 input 真的取得了焦點:

單擊「.triggerHandler」時只呼叫一次,input 沒有取得焦點:

原因就在於:trigger 觸發了瀏覽器預設的「取得焦點」行為,焦點移入又再次觸發 focus 事件,於是處理函式被執行了第二次。triggerHandler 只呼叫綁定的處理函式,不引起瀏覽器行為。
六、快捷事件 Event Helpers
jQuery 為常用事件提供了封裝。例如 click() 與 click(fn) 分別用來觸發單擊與設定單擊:
$("#testDiv").click(function(event) { alert("test div clicked ! "); });
等效於:
$("#testDiv").bind("click", function(event) { alert("test div clicked ! "); });
觸發單擊:
$("#testDiv").click();
等效於 $("#testDiv").trigger("click")——注意等效的是 trigger 而非 triggerHandler。
這類方法在 jQuery 中稱為 Event Helpers,我把它譯為「快捷方法」。清單如下:blur、change、click、dblclick、error、focus、keydown、keypress、keyup、load、mousedown、mouseenter、mouseleave、mousemove、mouseout、mouseover、mouseup、resize、scroll、select、submit、unload,每個都有「無參數=觸發」與「傳入函式=綁定」兩種形式。
七、兩個交互幫助方法
1. hover( over, out )
hover 主要解決原生 mouseover / mouseout 的問題。看下面的結構:
<div class="outer" id="outer1"> Outer 1
<div class="inner" id="inner1">Inner 1</div>
</div>
<div class="outer" id="outer2"> Outer 2
<div class="inner" id="inner2">Inner 2</div>
</div>
<div id="console"></div>

function report(event) {
$('#console').append('<div>'+event.type+'</div>');
}
$(function(){
$('#outer1')
.bind('mouseover',report)
.bind('mouseout',report);
$('#outer2').hover(report,report);
});
Outer1 使用 mouseover 與 mouseout。當滑鼠從 Outer1 的紅色區域移動到內部的黃色區域時,雖然還在 outer1 裡面,卻觸發了 mouseout:

我們通常不希望這樣,而是希望滑鼠在 Outer1 內部移動時不觸發事件。Outer2 用 hover() 就做到了:

注意這裡的事件名稱是「mouseenter」與「mouseleave」,而非 mouseover / mouseout。有經驗的開發者會立刻想到彈出菜單的經典問題:為菜單設了 mouseout 自動關閉,結果滑鼠在菜單內部移動時莫名其妙就被關掉。hover() 正好解決這個痛點。
2. toggle( fn, fn2, fn3, ... )
toggle 為元素添加 click 綁定,但每次點擊會依序呼叫下一個函式,到最後一個之後再回到第一個,形成輪番呼叫。可用 unbind("click") 移除。
$(function() {
$("li").toggle(
function() {
$(this).css({ "list-style-type": "disc", "color": "blue" });
},
function() {
$(this).css({ "list-style-type": "square", "color": "red" });
},
function() {
$(this).css({ "list-style-type": "none", "color": "" });
}
);
})
每點擊一次「click me」,項目符號與文字顏色就換一次。
八、使用 jQuery 事件物件
不同瀏覽器之間,事件物件的取得方式與屬性都有差異,導致很難跨瀏覽器使用。jQuery 統一了事件物件——綁定處理函式時,會把 jQuery 格式化後的事件物件作為唯一參數傳入:
$("#testDiv").bind("click", function(event) {
});
例如 event.target 在所有瀏覽器都能取得事件觸發者,而原生寫法在 IE 中要改用 event.srcElement。
跨瀏覽器屬性
type——事件型別,如 click。一個函式處理多個事件時很有用。
$("a").click(function(event) { alert(event.type); });
target——觸發事件的 DOM 物件。
$("a[href=https://google.com]").click(function(event) {
alert(event.target.href);
});
data——呼叫時傳入的額外參數。
$("a").each(function(i) {
$(this).bind('click', {index:i}, function(e){
alert('my index is ' + e.data.index);
});
});
relatedTarget——滑鼠事件中,觸發時離開或進入的 DOM 元素。
currentTarget——冒泡前的當前觸發物件,等同 this。
$("p").click(function(event) {
alert( event.currentTarget.nodeName );
});
pageX / pageY——滑鼠事件相對於頁面原點的座標。
result——上一個處理函式的回傳值。
timeStamp——事件發生的時間戳,可用來計算兩次事件的間隔。
另有幾個屬性同樣跨瀏覽器可用:altKey、ctrlKey、metaKey、shiftKey(判斷修飾鍵是否按下)、keyCode(keyup/keydown 下回傳按下的鍵,不分大小寫)、which(keypress 時較可靠,滑鼠事件中 1 左、2 中、3 右)、screenX/Y(相對於螢幕原點的座標)。
事件物件的方法
preventDefault()——取消可能引發預設語意的事件,例如 <a> 的跳轉、表單送出、click 引起的核取方塊狀態切換。
$("a").click(function(event){
event.preventDefault();
});
isDefaultPrevented()——是否呼叫過 preventDefault()。
stopPropagation()——取消事件冒泡,相當於原生寫法的 event.cancelBubble = true。這是最常用、幾乎一定會用到的方法。
$("p").click(function(event){
event.stopPropagation();
});
isPropagationStopped()——是否呼叫過 stopPropagation()。
stopImmediatePropagation()——取消執行其他的事件處理函式並同時取消冒泡。同一事件綁定多個函式時,呼叫它之後後續函式不會執行。
$("p").click(function(event){
event.stopImmediatePropagation();
});
$("p").click(function(event){
// 這個函式不會被執行
});
isImmediatePropagationStopped()——是否呼叫過 stopImmediatePropagation()。
九、總結
事件是 JavaScript 的靈魂,這篇翻譯並整理了 jQuery 官方 API 文件中的事件相關內容。事件機制的三個核心觀念值得記牢:用 bind/on 做多播委託而非直接賦值、用 hover 的 mouseenter/mouseleave 取代 mouseover/mouseout 以避開內部移動的誤觸、用 event 物件統一處理跨瀏覽器差異。
後續文章將講解 Ajax 與動畫效果,最後透過兩個改寫過的 jQuery 插件來說明插件開發。
作者:張子秋 出處:https://www.cnblogs.com/zhangziqiu/
(編按:本文寫於 jQuery 1.3 時期。bind、one、live、die 在 jQuery 3 中已移除,請一律改用 on / off / one;事件委派寫成 $(document).on('click', '.item', handler)。另外 jQuery 3 已不再需要為 IE8 以下做 event 物件正規化,上述許多屬性可直接使用原生事件物件。)