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

接口 Event

所有已知的子接口：
LSLoadEvent , LSProgressEvent , MouseEvent , MutationEvent , UIEvent
public interface Event
Event 接口用于向处理事件的处理程序提供有关事件的上下文信息。实现 Event 接口的对象通常作为第一个参数传递给事件处理程序。通过从 Event 派生附加接口，将更具体的上下文信息传递给事件处理程序，这些接口包含与它们伴随的事件类型直接相关的信息。这些派生接口也由传递给事件监听器的对象实现。

另见 文档对象模型 (DOM) 级别 2 事件规范 。

自从：
1.5、DOM 2 级

  • 字段摘要

    字段
    修饰符和类型
    Field
    描述
    static final short
    AT_TARGET
    当前正在目标 EventTarget 评估该事件。
    static final short
    BUBBLING_PHASE
    当前事件阶段是冒泡阶段。
    static final short
    CAPTURING_PHASE
    当前事件阶段是捕获阶段。

  • 方法总结

    修饰符和类型
    方法
    描述
    boolean
    getBubbles()
    用于表示事件是否为冒泡事件。
    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
      当前事件阶段是冒泡阶段。
      参见：

  • 方法详情

    • getType

      String  getType()
      事件的名称（不区分大小写）。该名称必须是 XML 名称。

    • getTarget

      EventTarget  getTarget()
      用于指示事件最初发送到的EventTarget。

    • getCurrentTarget

      EventTarget  getCurrentTarget()
      用于指示当前正在处理其 EventListeners 的 EventTarget。这在捕获和冒泡期间特别有用。

    • getEventPhase

      short getEventPhase()
      用于指示当前正在评估事件流的哪个阶段。

    • getBubbles

      boolean getBubbles()
      用于表示事件是否为冒泡事件。如果事件可以冒泡，则值为 true，否则值为 false。

    • getCancelable

      boolean getCancelable()
      用于指示事件是否可以阻止其默认操作。如果可以阻止默认操作，则值为 true，否则值为 false。

    • getTimeStamp

      long getTimeStamp()
      用于指定创建事件的时间（相对于纪元的毫秒数）。由于某些系统可能不提供此信息，timeStamp 的值可能不适用于所有事件。如果不可用，将返回值 0。纪元时间的示例是系统启动时间或 0:0:0 UTC 1970 年 1 月 1 日。

    • 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 - 指定事件是否可以冒泡。
      cancelableArg - 指定是否可以阻止事件的默认操作。