用事件就繞不開事件物件。麻煩的是各瀏覽器取得事件物件的方式不同、可用屬性也不同,很難跨瀏覽器寫。jQuery 把這層差異統一了:綁定事件處理函數時,會把 jQuery 格式化後的事件物件作為唯一參數傳進來。
$("#testDiv").bind("click", function(event) { });
官方文件:https://docs.jquery.com/Events/jQuery.Event
最典型的例子是觸發者:jQuery 統一提供 event.target,而原生寫法在 IE 下要用 event.srcElement。
事件類型。若同一個函數處理多種事件,可用它分辨,例如 click。
$("a").click(function(event) { alert(event.type); });
取得事件觸發者的 DOM 物件。
$("a[href=https://google.com]").click(function(event) {
alert(event.target.href);
});
綁定時額外傳入的參數。
$("a").each(function(i) {
$(this).bind('click', {index:i}, function(e){
alert('my index is ' + e.data.index);
});
});
滑鼠事件中,標示觸發事件時離開或進入的 DOM 元素。
$("a").mouseout(function(event) { alert(event.relatedTarget); });
事件冒泡前的當前觸發元素,等同 this。
$("p").click(function(event) { alert( event.currentTarget.nodeName ); }); // P
滑鼠事件中,相對於頁面原點的水平/垂直座標。
$("a").click(function(event) {
alert("Current mouse position: " + event.pageX + ", " + event.pageY );
});
前一個事件處理函數的回傳值。
$("p").click(function(event) { return "hey" });
$("p").click(function(event) { alert( event.result ); }); // "hey"
事件發生的時間戳,可用來算兩次事件的間隔。
var last;
$("p").click(function(event) {
if( last ) alert( "time since last event " + (event.timeStamp - last) );
last = event.timeStamp;
});
《jQuery 實戰》一書另外列了以下屬性,我沒有逐一實測,讀者可以幫忙驗證:
取消可能引發預設語意的事件,例如 <a> 的跳轉、表單提交、點擊造成 checkbox 狀態切換。
$("a").click(function(event){
event.preventDefault();
// do something
});
是否呼叫過 preventDefault()。
$("a").click(function(event){
alert( event.isDefaultPrevented() );
event.preventDefault();
alert( event.isDefaultPrevented() );
});
取消事件冒泡。
$("p").click(function(event){
event.stopPropagation();
// do something
});
是否呼叫過 stopPropagation()。
$("p").click(function(event){
alert( event.isPropagationStopped() );
event.stopPropagation();
alert( event.isPropagationStopped() );
});
取消事件冒泡,同時不再執行同一元素上後續的其他事件處理函數。
$("p").click(function(event){ event.stopImmediatePropagation(); });
$("p").click(function(event){
// 這個函數不會被執行
});
是否呼叫過 stopImmediatePropagation()。
$("p").click(function(event){
alert( event.isImmediatePropagationStopped() );
event.stopImmediatePropagation();
alert( event.isImmediatePropagationStopped() );
});
這些方法裡最常用的一定是 stopPropagation(),它相當於操作原生事件物件的 event.cancelBubble = true。另外提醒一個實務上很常踩的差異:preventDefault() 和 stopPropagation() 是兩件不同的事——前者阻止瀏覽器預設行為,後者阻止事件往父元素傳遞。而 return false 在 jQuery 的處理函數中等於兩者都做,這點寫的時候要清楚自己在要哪一個效果。