Module  java.xml
软件包  org.w3c.dom.events

Interface EventTarget



  • public interface EventTarget
    EventTarget接口由支持DOM事件模型的实现中的所有Nodes实现。 因此,可以通过在Node接口的实例上使用绑定特定的转换方法来获得此接口。 该界面允许在EventListeners上注册和删除EventTarget并将事件发送到该EventTarget

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

    从以下版本开始:
    1.5,DOM 2级
    • 方法详细信息

      • 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)
        此方法允许从事件目标中删除事件侦听器。 如果EventListenerEventTarget处理事件时被删除,则不会被当前操作触发。 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或空字符串也会触发此异常。