-
- All Known Subinterfaces:
-
LSLoadEvent
,LSProgressEvent
,MouseEvent
,MutationEvent
,UIEvent
public interface Event
Event
接口用于向处理事件的处理程序提供有关事件的上下文信息。 实现Event
接口的对象通常作为第一个参数传递给事件处理程序。 通过从Event
获得包含与其伴随的事件类型直接相关的信息的附加接口,Event
具体的上下文信息传递给事件处理程序。 这些派生接口也由传递给事件侦听器的对象实现。另见Document Object Model (DOM) Level 2 Events Specification 。
- 从以下版本开始:
- 1.5,DOM Level 2
-
-
字段汇总
字段 变量和类型 字段 描述 static short
AT_TARGET
该事件目前正在目标EventTarget
进行评估。static short
BUBBLING_PHASE
当前事件阶段是冒泡阶段。static short
CAPTURING_PHASE
当前事件阶段是捕获阶段。
-
方法摘要
所有方法 实例方法 抽象方法 变量和类型 方法 描述 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
通过创建DocumentEvent
接口。void
preventDefault()
如果事件可取消,则使用preventDefault
方法表示要取消事件,这意味着不会发生由于事件而通常由实现采取的任何默认操作。void
stopPropagation()
使用stopPropagation
方法防止在事件流期间进一步传播事件。
-
-
-
方法详细信息
-
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
通过创建DocumentEvent
接口。 只有在通过dispatchEvent
方法调度Event
之前,才能调用此方法,但如果需要,可以在该阶段调用多次。 如果多次调用,则最终调用优先。 如果从Event
接口的子类调用,Event
仅修改initEvent
方法中指定的值,所有其他属性保持不变。- 参数
-
eventTypeArg
- 指定事件类型。 此类型可以是当前在此规范中定义的任何事件类型或新的事件类型。该字符串必须是XML名称。 任何新的事件类型都不能以字符串“DOM”的任何大写,小写或混合大小写形式开头。 此前缀保留给将来的DOM事件集。 强烈建议第三方添加自己的事件使用自己的前缀以避免混淆并减少与其他新事件冲突的可能性。 -
canBubbleArg
- 指定事件是否可以冒泡。 -
cancelableArg
- 指定是否可以阻止事件的默认操作。
-
-