模块  java.xml
软件包  org.w3c.dom.events

Interface EventTarget

  • public interface EventTarget
    EventTarget接口由所有Nodes在支持DOM事件模型的实现中实现。 因此，可以通过在Node接口的实例上使用特定于绑定的转换方法来获取此接口。 该接口允许登记和去除EventListeners上EventTarget和调度事件到的EventTarget 。

    另见Document Object Model (DOM) Level 2 Events Specification 。

    从以下版本开始：
    1.5，DOM Level 2

    • 方法详细信息

      • addEventListener

        void addEventListener​(String type,                      EventListener listener,                      boolean useCapture)
        此方法允许在事件目标上注册事件侦听器。 如果在处理事件时将EventListener添加到EventTarget ，则它不会被当前操作触发，但可能在事件流的后续阶段（例如冒泡阶段）触发。
        如果多个相同的EventListener在具有相同参数的同一EventTarget上注册，则丢弃重复实例。 它们不会导致EventListener被调用两次，因为它们被丢弃，所以不需要使用removeEventListener方法将其删除。
        参数
        type - 用户正在注册的事件类型
        listener - listener参数采用用户实现的接口，该接口包含事件发生时要调用的方法。
        useCapture - 如果为true，则useCapture指示用户希望启动捕获。 启动捕获后，指定类型的所有事件将被分派到已注册的EventListener然后再分派到树中它们下面的任何EventTargets 。 向上冒泡树的事件不会触发指定使用捕获的EventListener 。

      • removeEventListener

        void removeEventListener​(String type,                         EventListener listener,                         boolean useCapture)
        此方法允许从事件目标中删除事件侦听器。 如果EventTarget在处理事件时从EventListener中删除，则当前操作不会触发它。 删除后永远不能调用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或空字符串也会触发此异常。