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

浏览器兼容性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
initUIEvent
Deprecated

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Deprecated. Not for use in new websites.

参见

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