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