Event

正在翻譯中。

Event 介面表示了所有在 DOM 物件上發生的事件;部分事件是由瀏覽器偵測使用者的操作行為所產生(如滑鼠或鍵盤事件),而其它則是由 API 所產生(例如動畫執行結束、影片暫停播放的事件等等)。事件分為許多不同的類型,其實體通常是由 Event 的子介面所建構。而 Event 介面則定義了所有事件共通的屬性及方法。

基於 Event 的子介面

Below is a list of interfaces which are based on the main Event interface, with links to their respective documentation in the MDN API reference. Note that all event interfaces have names which end in "Event".

建構式

Event()
建立一個 Event 物件。

屬性

Event.bubbles Read only
布林值,表示事件是否會向上冒泡傳遞。
Event.cancelBubble
由於歷史性因素,此屬性的效果等同於 stopPropagation() 方法。若在事件處理器回傳前設定此值為 true,可阻止事件繼續向上冒泡傳遞。
Event.cancelable Read only
布林值,表示事件是否能被取消。
Event.composed Read only
A Boolean value indicating whether or not the event can bubble across the boundary between the shadow DOM and the regular DOM.
Event.currentTarget Read only
指向目前處理事件之監聽器所屬的 DOM 物件。
Event.deepPath 
An Array of DOM Nodes through which the event has bubbled.
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.scoped Read only
A Boolean indicating whether the given event will bubble across through the shadow root into the standard DOM. This property has been renamed to composed.
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 屬性。

規範

Specification Status Comment
DOM
The definition of 'Event' in that specification.
Living Standard  

瀏覽器相容性

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support (Yes) (Yes) (Yes) (Yes) (Yes)
cancelBubble defined on Event ? 53 (53)[1] ? ? ?
Feature Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support (Yes) (Yes) (Yes) (Yes) (Yes)
cancelBubble defined on Event ? 53.0 (53)[1] ? ? ?

[1] Previous to Firefox 53, this property was defined on the UIEvent interface. See bug 1298970 for more details.

參見

文件標籤與貢獻者

 此頁面的貢獻者: jackblackevo, Shiyou, Sheppy
 最近更新: jackblackevo,