Event

Event 介面定義了 DOM 物件的所有事件，包括每一個事件物件的共同屬性和方法。

許多介面繼承了 Event。除了直接繼承外，有些是繼承自其它的 Event 子介面：

建構式

Event()

建立一個 Event 物件。

屬性

Event.bubbles Read only

布林值，表示事件是否會向上冒泡傳遞。

Event.cancelBubble

非標準屬性。布林值，表示事件是否會繼續向上冒泡傳遞，可被 stopPropagation() 方法取代。

Event.cancelable Read only

布林值，表示事件是否能被取消。

Event.currentTarget Read only

指向目前處理事件之監聽器所屬的 DOM 物件。

Event.defaultPrevented Read only

布林值，表示事件的預設行為是否被 preventDefault() 方法所取消。

Event.eventPhase Read only

表示事件目前的傳遞階段。

Event.explicitOriginalTarget Read only

事件的明確原定目標（Mozilla 專屬）。

Event.originalTarget Read only

事件重新導向前的原定目標（Mozilla 專屬）。

Event.returnValue

非標準屬性。用以替代 preventDefault() 方法與 defaultPrevented 屬性（舊版 Internet Explorer 專屬）。

Event.srcElement

非標準屬性。為 target 屬性的別名（舊版 Internet Explorer 專屬）。

Event.target Read only

指向最初觸發事件的 DOM 物件。

Event.timeStamp Read only

事件發生（事件物件建立）至今的時間。

Event.type Read only

事件類型（不區分大小寫）。

Event.isTrusted Read only

表示事件物件是否為瀏覽器建立（比如在用戶點擊之後），或由程式碼所建立（使用建立事件的方法，如 initEvent()）。

方法

Event.initEvent()

初始化已經建立的事件。若該事件已經被處理過，這方法就不會執行任何東西。

Event.preventBubble() 已過時 Gecko 24

已淘汰方法。阻止事件繼續冒泡傳遞。請改用 stopPropagation() 方法。

Event.preventCapture() 已過時 Gecko 24

已淘汰方法。請改用 stopPropagation() 方法。

Event.preventDefault()

取消該事件（如果該事件的 cancelable 屬性為 true）。

Event.stopImmediatePropagation()

一旦事件物件呼叫此方法，目前元素中尚未執行的已註冊之相同事件類型監聽器將不會被呼叫，而事件也不會繼續捕捉或冒泡傳遞。

Event.stopPropagation()

阻止事件物件繼續捕捉或冒泡傳遞。

Event.getPreventDefault()

非標準方法。回傳 defaultPrevented 屬性值。請直接改用 defaultPrevented 屬性。

參見

• 可用的事件類型： Event reference
• 各種Event Targets的比較 (target vs currentTarget vs relatedTarget vs originalTarget)
• 建立和觸發事件
• 給 Firefox 插件開發者：
  • Listening to events in Firefox extensions
  • Listening to events on all tabs