org.w3c.dom.events
介面 EventTarget

public interface EventTarget

EventTarget 介面由支持 DOM Event Model 的實作中的所有 Nodes 實作。因此，此介面可以通過在 Node 介面的實例上使用特定於綁定的強制轉換方法獲得。該介面允許在 EventTarget 上註冊和移除 EventListeners，並將事件指派給 EventTarget。

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

從以下版本開始：

DOM Level 2

方法摘要

void	addEventListener(String type, EventListener listener, boolean useCapture) 此方法允許在事件目標上註冊事件偵聽器。
boolean	dispatchEvent(Event evt) 此方法允許將事件指派到實作事件模型。
void	removeEventListener(String type, EventListener listener, boolean useCapture) 此方法允許從事件目標移除事件偵聽器。

方法詳細資訊

addEventListener

void addEventListener(String type,
                      EventListener listener,
                      boolean useCapture)

此方法允許在事件目標上註冊事件偵聽器。如果在處理事件時將 EventListener 添加到 EventTarget，則該事件將不會通過當前操作觸發，但可以在事件串流後面的階段（如 bubbling 階段）觸發。
如果使用同樣的參數在同一個 EventTarget 上註冊多個相同的 EventListener，則丟棄重複的實例。它們不會引起兩次調用 EventListener，並且由於被丟棄，它們不需要使用 removeEventListener 方法移除。

參數：

type - 使用者正在註冊的事件型別

listener - listener 參數採用由使用者實作的介面，該介面包含事件發生時要調用的方法。

useCapture - 如果為 true，則 useCapture 指示使用者希望啟動捕獲。啟動捕獲後，所有指定型別的事件將在被指派到階層樹中其下面的任何 EventTargets 之前指派給已註冊的 EventListener。正在通過階層樹向上 bubbling 的事件將不觸發指定的使用捕獲的 EventListener。

removeEventListener

void removeEventListener(String type,
                         EventListener listener,
                         boolean useCapture)

此方法允許從事件目標移除事件偵聽器。如果 EventListener 在處理事件時從 EventTarget 移除，則它不會由當前操作觸發。EventListener 永遠不能在移除後被調用。
用不標識在 EventTarget 上的任何當前已註冊的 EventListener 的參數調用 removeEventListener 時無效。

參數：

type - 指定正在被移除的 EventListener 的事件型別。

listener - 該 EventListener 參數指示要被移除的 EventListener 。

useCapture - 指定正被移除的 EventListener 是否是作為捕獲偵聽器註冊的。如果一個偵聽器註冊了兩次，一次帶有捕獲，一次不帶捕獲，每次都必須單獨移除。移除捕獲偵聽器不影響同一偵聽器的非捕獲版本，反之亦然。

dispatchEvent

boolean dispatchEvent(Event evt)
                      throws EventException

此方法允許將事件指派到實作事件模型。以此方式指派的事件將與直接由實作指派的事件有相同的捕獲和 bubbling 行為。事件的目標是在其上調用 dispatchEvent 的 EventTarget。

參數：

evt - 指定用於處理事件的事件型別、行為或上下文資訊。

返回：

dispatchEvent 的返回值指示處理事件的任何一個偵聽器是否調用了 preventDefault。如果調用了 preventDefault，則值為 false；否則該值為 true。

拋出：

EventException - UNSPECIFIED_EVENT_TYPE_ERR: 如果 Event 的型別不是在調用 dispatchEvent 之前通過初始化該事件指定的，則引發該異常。把 Event 的型別指定為 null 或空字元串也會觸發此異常。