DIV CSS 佈局教程網

jQuery 事件物件屬性與方法整理
編輯:JQuery特效代碼     

用事件就繞不開事件物件。麻煩的是各瀏覽器取得事件物件的方式不同、可用屬性也不同,很難跨瀏覽器寫。jQuery 把這層差異統一了:綁定事件處理函數時,會把 jQuery 格式化後的事件物件作為唯一參數傳進來。

$("#testDiv").bind("click", function(event) { });

官方文件:https://docs.jquery.com/Events/jQuery.Event

最典型的例子是觸發者:jQuery 統一提供 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 元素。

$("a").mouseout(function(event) { alert(event.relatedTarget); });

currentTarget

事件冒泡前的當前觸發元素,等同 this。

$("p").click(function(event) { alert( event.currentTarget.nodeName ); });   // P

pageX / pageY

滑鼠事件中,相對於頁面原點的水平/垂直座標。

$("a").click(function(event) {
  alert("Current mouse position: " + event.pageX + ", " + event.pageY );
});

result

前一個事件處理函數的回傳值。

$("p").click(function(event) { return "hey" });
$("p").click(function(event) { alert( event.result ); });   // "hey"

timeStamp

事件發生的時間戳,可用來算兩次事件的間隔。

var last;
$("p").click(function(event) {
  if( last ) alert( "time since last event " + (event.timeStamp - last) );
  last = event.timeStamp;
});

其他多瀏覽器屬性


《jQuery 實戰》一書另外列了以下屬性,我沒有逐一實測,讀者可以幫忙驗證:

  • altKey / ctrlKey / metaKey / shiftKey:對應按鍵是否被按下,按下回傳 true。metaKey 在 PC 上等同 Ctrl 鍵,在 Mac 上是 Command 鍵。
  • keyCode:keyup 與 keydown 事件中回傳被按下的按鍵,不分大小寫(a 和 A 都是 65)。keypress 事件請改用 which,因為 which 在跨瀏覽器時較可靠。
  • which:鍵盤事件回傳按鍵的數字編碼;滑鼠事件回傳按鍵號(1 左、2 中、3 右)。
  • screenX / screenY:滑鼠事件中相對於螢幕原點的座標。

事件物件的方法


preventDefault()

取消可能引發預設語意的事件,例如 <a> 的跳轉、表單提交、點擊造成 checkbox 狀態切換。

$("a").click(function(event){
  event.preventDefault();
  // do something
});

isDefaultPrevented()

是否呼叫過 preventDefault()。

$("a").click(function(event){
  alert( event.isDefaultPrevented() );
  event.preventDefault();
  alert( event.isDefaultPrevented() );
});

stopPropagation()

取消事件冒泡。

$("p").click(function(event){
  event.stopPropagation();
  // do something
});

isPropagationStopped()

是否呼叫過 stopPropagation()。

$("p").click(function(event){
  alert( event.isPropagationStopped() );
  event.stopPropagation();
  alert( event.isPropagationStopped() );
});

stopImmediatePropagation()

取消事件冒泡,同時不再執行同一元素上後續的其他事件處理函數。

$("p").click(function(event){ event.stopImmediatePropagation(); });
$("p").click(function(event){
  // 這個函數不會被執行
});

isImmediatePropagationStopped()

是否呼叫過 stopImmediatePropagation()。

$("p").click(function(event){
  alert( event.isImmediatePropagationStopped() );
  event.stopImmediatePropagation();
  alert( event.isImmediatePropagationStopped() );
});

這些方法裡最常用的一定是 stopPropagation(),它相當於操作原生事件物件的 event.cancelBubble = true。另外提醒一個實務上很常踩的差異:preventDefault() 和 stopPropagation() 是兩件不同的事——前者阻止瀏覽器預設行為,後者阻止事件往父元素傳遞。而 return false 在 jQuery 的處理函數中等於兩者都做,這點寫的時候要清楚自己在要哪一個效果。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved