org.w3c.dom.events
介面 Event

所有已知子介面：

LSLoadEvent, LSProgressEvent, MouseEvent, MutationEvent, UIEvent

public interface Event

Event 介面用於為處理事件的處理程序提供關於事件的上下文資訊。實作 Event 介面的物件通常作為第一個參數傳遞給事件處理程序。從 Event(包含與它們附帶的事件型別直接相關的資訊)派生其他介面，可以將更多特定的上下文資訊傳遞給事件處理程序。這些派生的介面也由傳遞給事件偵聽器的物件實作。

另請參見 Document Object Model (DOM) Level 2 Events Specification。

從以下版本開始：

DOM Level 2

欄位摘要

static short	AT_TARGET 目前事件正在目標 EventTarget 接受評詁。
static short	BUBBLING_PHASE 當前的事件階段為 bubbling 階段。
static short	CAPTURING_PHASE 當前的事件階段是捕獲階段。

方法摘要

boolean	getBubbles() 用於指示事件是否是 bubbling 事件。
boolean	getCancelable() 用於指示事件是否可以阻止其預設操作。
EventTarget	getCurrentTarget() 用於指示當前正在處理其 EventListeners 的 EventTarget。
short	getEventPhase() 用於指示當前正在評詁哪個階段的事件串流。
EventTarget	getTarget() 用於指示 EventTarget，最初將事件指派給它。
long	getTimeStamp() 用於指定創建事件的時間（與歷元相關，以毫秒為單位）。
String	getType() 事件的名稱（不區分大小寫）。
void	initEvent(String eventTypeArg, boolean canBubbleArg, boolean cancelableArg) initEvent 方法用於初始化通過 DocumentEvent 介面創建的 Event 的值。
void	preventDefault() 如果事件可取消，則 preventDefault 方法用於表示要取消該事件，意味著作為事件結果的、通常由該實作採取的任何預設操作將不出現。
void	stopPropagation() stopPropagation 方法用於阻止在事件串流期間事件的進一步傳播。

欄位詳細資訊

CAPTURING_PHASE

static final short CAPTURING_PHASE

當前的事件階段是捕獲階段。

另請參見：

常數欄位值

AT_TARGET

static final short AT_TARGET

目前事件正在目標 EventTarget 接受評詁。

另請參見：

常數欄位值

BUBBLING_PHASE

static final short BUBBLING_PHASE

當前的事件階段為 bubbling 階段。

另請參見：

常數欄位值

方法詳細資訊

getType

String getType()

事件的名稱（不區分大小寫）。該名稱必須是 XML 名稱。

getTarget

EventTarget getTarget()

用於指示 EventTarget，最初將事件指派給它。

getCurrentTarget

EventTarget getCurrentTarget()

用於指示當前正在處理其 EventListeners 的 EventTarget。這在捕獲和 bubbling 期間特別有用。

getEventPhase

short getEventPhase()

用於指示當前正在評詁哪個階段的事件串流。

getBubbles

boolean getBubbles()

用於指示事件是否是 bubbling 事件。如果事件可以 bubble，則值為 true；否則值為 false。

getCancelable

boolean getCancelable()

用於指示事件是否可以阻止其預設操作。如果可以阻止預設操作，則值為 true；否則值為 false。

getTimeStamp

long getTimeStamp()

用於指定創建事件的時間（與歷元相關，以毫秒為單位）。由於有些系統不能提供此資訊，timeStamp 的值可能不是對所有事件都可用。當不可用時，將返回值 0。歷元時間的範例是系統啟動時間，或者 UTC 時間 1970 年 1 月 1 日 0:0:0。

stopPropagation

void stopPropagation()

stopPropagation 方法用於阻止在事件串流期間事件的進一步傳播。如果任何 EventListener 調用此方法，則該事件將終止沿著階層樹傳播。事件串流停止之前，該事件將完成向當前 EventTarget 上的所有偵聽器的指派。在事件串流的任何階段都可以使用此方法。

preventDefault

void preventDefault()

如果事件可取消，則 preventDefault 方法用於表示要取消該事件，意味著作為事件結果的、通常由該實作採取的任何預設操作將不出現。在事件串流的任何階段，如果調用 preventDefault 方法，則取消該事件。與該事件相關聯的任何預設操作都不會發生。對非可取消的事件調用此方法無效。一旦調用 preventDefault，在事件傳播的剩餘時間內它仍有效。在事件串流的任何階段都可以使用此方法。

initEvent

void initEvent(String eventTypeArg,
               boolean canBubbleArg,
               boolean cancelableArg)

initEvent 方法用於初始化通過 DocumentEvent 介面創建的 Event 的值。此方法只能在通過 dispatchEvent 方法指派 Event 之前調用，儘管在該階段可以多次調用它（如有必要）。如果被多次調用，則最後一次調用優先。如果從 Event 介面的子類別調用，則只修改在 initEvent 方法中指定的值，所有其他屬性保持不變。

參數：

eventTypeArg - 指定事件型別。此型別可以是當前在此規範中定義的任何事件型別，或是一個新的事件型別。該字元串必須是 XML 名稱。任何新的事件型別一定不能以字元串 "DOM" 的大寫、小寫或混合大小寫版本開頭。此前綴是為以後的 DOM 事件集保留的。還強烈推薦添加自己的事件的第三方使用自己的前綴以避免混淆，降低與其他新的事件發生衝突的可能性。

canBubbleArg - 指定該事件是否可以 bubble。

cancelableArg - 指定是否可以阻止事件的預設操作。