-
- All Known Subinterfaces:
-
LSLoadEvent,LSProgressEvent,MouseEvent,MutationEvent,UIEvent
public interface EventEvent接口用于向事件处理程序提供有关事件的上下文信息。 实现Event接口的对象通常作为第一个参数传递给事件处理程序。 更具体的上下文信息通过从Event导出附加接口传递给事件处理程序,其中包含与其所附的事件类型直接相关的信息。 这些派生接口也由传递给事件侦听器的对象实现。另见Document Object Model (DOM) Level 2 Events Specification 。
- 从以下版本开始:
- 1.5,DOM 2级
-
-
Field Summary
Fields Modifier and Type Field 描述 static shortAT_TARGET该事件目前正在目标评估EventTarget。static shortBUBBLING_PHASE当前事件阶段是冒泡阶段。static shortCAPTURING_PHASE当前的事件阶段是捕获阶段。
-
方法摘要
所有方法 接口方法 抽象方法 Modifier and Type 方法 描述 booleangetBubbles()用于指示事件是否是冒泡事件。booleangetCancelable()用于指示事件是否可以防止其默认动作。EventTargetgetCurrentTarget()用于指示目前正在处理其中的EventTarget的EventListeners。shortgetEventPhase()用于指示当前正在评估事件流的哪个阶段。EventTargetgetTarget()用于指示事件最初发送到的EventTarget。longgetTimeStamp()用于指定创建事件的时间(以秒为单位)。StringgetType()事件的名称(不区分大小写)。voidinitEvent(String eventTypeArg, boolean canBubbleArg, boolean cancelableArg)initEvent方法用于初始化通过Event创建的DocumentEvent接口的值。voidpreventDefault()如果事件是可取消的,则使用preventDefault方法来表示事件将被取消,这意味着由于事件而导致的实现通常采取的任何默认操作都不会发生。voidstopPropagation()使用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- 指定是否可以防止事件的默认动作。
-
-