compact2, compact3

org.w3c.dom.events

Interface Event

All Known Subinterfaces:

LSLoadEvent ， LSProgressEvent ， MouseEvent ， MutationEvent ， UIEvent

public interface Event

Event接口用于向事件处理程序提供有关事件的上下文信息。 实现Event接口的对象通常作为第一个参数传递给事件处理程序。 更具体的上下文信息通过从Event导出附加接口传递给事件处理程序，其中包含与它们相关的事件类型直接相关的信息。 这些派生接口也由传递给事件侦听器的对象实现。

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

从以下版本开始：

DOM级别2

Field Summary

Fields

Modifier and Type	Field and Description
static short	AT_TARGET 该事件目前正在目标 EventTarget 。
static short	BUBBLING_PHASE 当前的事件阶段是冒泡阶段。
static short	CAPTURING_PHASE 当前的事件阶段是捕获阶段。

方法摘要

Modifier and Type	Method and Description
boolean	getBubbles() 用于指示事件是否是冒泡事件。
boolean	getCancelable() 用于指示事件是否可以防止其默认动作。
EventTarget	getCurrentTarget() 用于指示 EventTarget其 EventListeners ，目前正在处理。
short	getEventPhase() 用于指示当前正在评估事件流的哪个阶段。
EventTarget	getTarget() 用于指示 EventTarget到最初被分派的事件。
long	getTimeStamp() 用于指定创建事件的时间（以秒为单位的毫秒）。
String	getType() 事件的名称（不区分大小写）。
void	initEvent(String eventTypeArg, boolean canBubbleArg, boolean cancelableArg) initEvent方法用于 Event通过 Event创建的 DocumentEvent值。
void	preventDefault() 如果事件是可取消的，则使用 preventDefault方法来表示事件将被取消，这意味着由于事件而导致的实现中通常采取的任何默认操作都不会发生。
void	stopPropagation() stopPropagation方法用于防止在事件流中事件的进一步传播。

字段详细信息

CAPTURING_PHASE

static final short CAPTURING_PHASE

当前的事件阶段是捕获阶段。

另请参见：

Constant Field Values

AT_TARGET

static final short AT_TARGET

目前正在对目标进行 EventTarget 。

另请参见：

Constant Field Values

BUBBLING_PHASE

static final short BUBBLING_PHASE

当前的事件阶段是冒泡阶段。

另请参见：

Constant Field Values

方法详细信息

getType

String getType()

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

getTarget

EventTarget getTarget()

用于指示 EventTarget到最初被分派的事件。

getCurrentTarget

EventTarget getCurrentTarget()

用于指示EventTarget其EventListeners ，目前正在处理。 这在捕获和冒泡时特别有用。

getEventPhase

short getEventPhase()

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

getBubbles

boolean getBubbles()

用于指示事件是否是冒泡事件。 如果事件可以浮动，则值为true，否则该值为false。

getCancelable

boolean getCancelable()

用于指示事件是否可以防止其默认动作。 如果可以防止缺省动作，则该值为true，否则该值为false。

getTimeStamp

long getTimeStamp()

用于指定创建事件的时间（以秒为单位的毫秒）。 由于这样的事实，有些系统不能提供此信息的价值timeStamp可能并不适用于所有的事件。 当不可用时，将返回值0。 时代的例子是系统启动的时间或1970年1月1日的0：0：0 UTC。

stopPropagation

void stopPropagation()

stopPropagation方法用于防止事件流中事件的进一步传播。 如果这种方法被任何EventListener ，事件将停止通过树传播。 在事件流程停止之前，该事件将完成对当前EventTarget所有侦听器的调度。 该方法可以在事件流的任何阶段使用。

preventDefault

void preventDefault()

如果事件是可取消的，则使用preventDefault方法来表示事件将被取消，这意味着由于事件而导致的实现中通常采取的任何默认操作都不会发生。 如果在事件流程的任何阶段， preventDefault方法称为事件被取消。 与事件关联的任何默认操作都不会发生。 将此方法调用为不可取消事件不起作用。 一旦preventDefault被调用，它将在整个事件的传播过程中保持有效。 该方法可以在事件流的任何阶段使用。

initEvent

void initEvent(String eventTypeArg,
               boolean canBubbleArg,
               boolean cancelableArg)

initEvent方法用于Event通过Event创建的DocumentEvent值。 在之前，此方法只能被称为Event已经通过被派遣dispatchEvent方法，虽然它可能在该阶段，如果需要多次调用。 如果多次调用最终调用优先级。 如果从Event接口的子类调用， Event修改initEvent方法中指定的值，所有其他属性保持不变。

参数

eventTypeArg - 指定事件类型。 此类型可以是本规范中当前定义的任何事件类型或新的事件类型。该字符串必须是XML名称。 任何新的事件类型不能以字符串“DOM”的任何上，下或混合大小写的形式开头。 该前缀保留用于将来的DOM事件集。 还强烈建议第三方添加自己的事件使用自己的前缀来避免混淆，并减少与其他新事件冲突的可能性。

canBubbleArg - 指定事件是否可以起泡。

cancelableArg - 指定是否可以防止事件的默认动作。