UIEvent:initUIEvent() 方法

已弃用: 不再推荐使用该特性。虽然一些浏览器仍然支持它,但也许已从相关的 web 标准中移除,也许正准备移除或出于兼容性而保留。请尽量不要使用该特性,并更新现有的代码;参见本页面底部的兼容性表格以指导你作出决定。请注意,该特性随时可能无法正常工作。

UIEvent.initUIEvent() 方法在创建 UI 事件后对其进行初始化。

以这种方式初始化的事件必须使用 Document.createEvent() 方法创建。使用 EventTarget.dispatchEvent() 派发前必须调用该方法来设置事件。一旦派发,它就什么都不做了。

警告: 请勿再使用此方法,因为它已被弃用。

请使用特定的事件构造函数代替,例如:UIEvent()创建和触发事件页面提供了有关使用方法的更多信息。

语法

js
initUIEvent(type, canBubble, cancelable, view, detail)

参数

type

定义事件类型的字符串。

canBubble

一个布尔值,决定事件是否应该在事件链中冒泡。一旦设置,只读属性 Event.bubbles 将给出其值。

cancelable

一个布尔值,定义事件是否可以取消。一旦设置,只读属性 Event.cancelable 将给出其值。

view

一个与事件相关联的 WindowProxy

detail

一个 unsigned long 值,根据事件的类型指定有关事件的一些详细信息。对于鼠标事件,它表示在给定的屏幕位置上单击鼠标的次数。

返回值

无(undefined)。

示例

js
const e = document.createEvent("UIEvent");
// 创建一个冒泡的点击事件,可以取消,
// 并且其 view 和 detail 属性分别初始化为 window 和 1
e.initUIEvent("click", true, true, window, 1);

规范

Specification
UI Events
# dom-uievent-inituievent

浏览器兼容性

BCD tables only load in the browser

参见

  • UIEvent
  • 使用构造函数 UIEvent() 替代这个已经弃用的方法。也可以使用更具体的构造函数。