UIEvent:initUIEvent() 方法

已弃用:此特性不再推荐。虽然某些浏览器可能仍然支持它,但它可能已经从相关的网络标准中删除,可能正在删除过程中,或者可能仅为兼容性目的而保留。请避免使用它,如果可能,请更新现有代码;请参阅本页底部的兼容性表格以指导您的决策。请注意,此特性可能随时停止工作。

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");
// creates a click event that bubbles, can be cancelled,
// and with its view and detail property initialized to window and 1,
// respectively
e.initUIEvent("click", true, true, window, 1);

规范

规范
UI 事件
# dom-uievent-inituievent

浏览器兼容性

另见

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