Module java.xml
Package org.w3c.dom.events

Interface Event

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

另请参阅文档对象模型（DOM）Level 2事件规范。

自：
1.5, DOM Level 2

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final short
    AT_TARGET
    事件当前正在目标EventTarget处评估。
    static final short
    BUBBLING_PHASE
    当前事件阶段为冒泡阶段。
    static final short
    CAPTURING_PHASE
    当前事件阶段为捕获阶段。

  • Method Summary

    Modifier and Type
    Method
    Description
    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方法用于在事件流期间阻止事件的进一步传播。

  • Field Details

    • CAPTURING_PHASE

      static final short CAPTURING_PHASE
      当前事件阶段为捕获阶段。
      另请参阅：

    • AT_TARGET

      static final short AT_TARGET
      事件当前正在目标EventTarget处评估。
      另请参阅：

    • BUBBLING_PHASE

      static final short BUBBLING_PHASE
      当前事件阶段为冒泡阶段。
      另请参阅：

  • Method Details

    • 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。时代时间的示例是系统启动时间或1970年1月1日UTC 0:0:0。

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