public interface Event
Event
接口用于向事件处理程序提供有关事件的上下文信息。
实现Event
接口的对象通常作为第一个参数传递给事件处理程序。
更具体的上下文信息通过从Event
导出附加接口传递给事件处理程序,其中包含与它们相关的事件类型直接相关的信息。
这些派生接口也由传递给事件侦听器的对象实现。
另见Document Object Model (DOM) Level 2 Events Specification 。
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 方法用于防止在事件流中事件的进一步传播。
|
static final short CAPTURING_PHASE
static final short AT_TARGET
EventTarget
。
static final short BUBBLING_PHASE
String getType()
EventTarget getTarget()
EventTarget
到最初被分派的事件。
EventTarget getCurrentTarget()
EventTarget
其EventListeners
,目前正在处理。
这在捕获和冒泡时特别有用。
short getEventPhase()
boolean getBubbles()
boolean getCancelable()
long getTimeStamp()
timeStamp
可能并不适用于所有的事件。
当不可用时,将返回值0。
时代的例子是系统启动的时间或1970年1月1日的0:0:0 UTC。
void stopPropagation()
stopPropagation
方法用于防止事件流中事件的进一步传播。
如果这种方法被任何EventListener
,事件将停止通过树传播。
在事件流程停止之前,该事件将完成对当前EventTarget
所有侦听器的调度。
该方法可以在事件流的任何阶段使用。
void preventDefault()
preventDefault
方法来表示事件将被取消,这意味着由于事件而导致的实现中通常采取的任何默认操作都不会发生。
如果在事件流程的任何阶段, preventDefault
方法称为事件被取消。
与事件关联的任何默认操作都不会发生。
将此方法调用为不可取消事件不起作用。
一旦preventDefault
被调用,它将在整个事件的传播过程中保持有效。
该方法可以在事件流的任何阶段使用。
void initEvent(String eventTypeArg, boolean canBubbleArg, boolean cancelableArg)
initEvent
方法用于Event
通过Event
创建的DocumentEvent
值。
在之前,此方法只能被称为Event
已经通过被派遣dispatchEvent
方法,虽然它可能在该阶段,如果需要多次调用。
如果多次调用最终调用优先级。
如果从Event
接口的子类调用, Event
修改initEvent
方法中指定的值,所有其他属性保持不变。
eventTypeArg
- 指定事件类型。
此类型可以是本规范中当前定义的任何事件类型或新的事件类型。该字符串必须是XML名称。
任何新的事件类型不能以字符串“DOM”的任何上,下或混合大小写的形式开头。
该前缀保留用于将来的DOM事件集。
还强烈建议第三方添加自己的事件使用自己的前缀来避免混淆,并减少与其他新事件冲突的可能性。
canBubbleArg
- 指定事件是否可以起泡。
cancelableArg
- 指定是否可以防止事件的默认动作。