-
public interface EventTarget
EventTarget
接口由支持DOM事件模型的实现中的所有Nodes
实现。 因此,可以通过在Node
接口的实例上使用绑定特定的转换方法来获得此接口。 该界面允许在EventListeners
上注册和删除EventTarget
并将事件发送到该EventTarget
。另见Document Object Model (DOM) Level 2 Events Specification 。
- 从以下版本开始:
- 1.5,DOM 2级
-
-
方法摘要
所有方法 接口方法 抽象方法 Modifier and Type 方法 描述 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
,则不会由当前操作触发,但可能会在事件流的后期(例如冒泡阶段)触发。
如果多个相同EventListener
s的注册在同一EventTarget
具有相同参数的重复的实例被丢弃。 它们不会导致EventListener
被调用两次,并且由于它们被丢弃,因此不需要使用removeEventListener
方法将其删除。- 参数
-
type
- 用户正在注册的事件类型 -
listener
-listener
参数采用用户实现的接口,该接口包含事件发生时要调用的方法。 -
useCapture
- 如果为真,则useCapture
表示用户希望启动捕获。 启动捕获后,指定类型的所有事件将被发送到已注册的EventListener
然后再将其发送到EventTargets
任何EventTargets
。 通过树向上冒泡的事件不会触发指定使用捕获的EventListener
。
-
removeEventListener
void removeEventListener(String type, EventListener listener, boolean useCapture)
此方法允许从事件目标中删除事件侦听器。 如果EventListener
在EventTarget
处理事件时被删除,则不会被当前操作触发。EventListener
在被删除后永远不能被调用。
调用removeEventListener
,其参数不会在EventListener
上识别任何当前注册的EventTarget
没有任何效果。- 参数
-
type
- 指定要删除的EventListener
的事件类型。 -
listener
-EventListener
参数表示要删除的EventListener
。 -
useCapture
- 指定被删除的EventListener
是否被注册为捕获侦听器。 如果一个监听器被注册了两次,一个被捕获,一个没有,每个都必须被单独删除。 删除捕获侦听器不会影响同一侦听器的非捕获版本,反之亦然。
-
dispatchEvent
boolean dispatchEvent(Event evt) throws EventException
该方法允许将事件分派到实现事件模型中。 以这种方式发送的事件将具有与实现直接发送的事件相同的捕获和冒泡行为。 事件的目标是EventTarget
,其中dispatchEvent
。- 参数
-
evt
- 指定用于处理事件的事件类型,行为和上下文信息。 - 结果
-
dispatchEvent
的返回值指示处理事件的任何监听器是否为preventDefault
。 如果preventDefault
被称为值为false,否则该值为true。 - 异常
-
EventException
-EventException
:如果在Event
之前初始化事件未指定Event
的类型,则dispatchEvent
。 规定Event
的类型为null
或空字符串也会触发此异常。
-
-