UI Events
MouseEvent.initMouseEvent() 方法用于在鼠标事件创建时(一般通过 Document.createEvent() 方法创建)初始化其属性的值。
[!NOTE] 该方法已被弃用,请勿再使用。
使用特定的事件构造器,如 MouseEvent.MouseEvent 替代它。创建和派发事件一节提供了更多有关使用这些事件的方法的信息。
以这种方式初始化的事件必须是用 Document.createEvent() 方法创建的。在使用 EventTarget.dispatchEvent() 派发事件之前,必须调用该方法来设置事件。
语法
initMouseEvent(type, canBubble, cancelable, view,
detail, screenX, screenY, clientX, clientY,
ctrlKey, altKey, shiftKey, metaKey,
button, relatedTarget)
参数
-
type- : 设置事件类型(Event.type)的字符串,包含以下几种鼠标事件:
click、mousedown、mouseup、mouseover、mousemove、mouseout。
- : 设置事件类型(Event.type)的字符串,包含以下几种鼠标事件:
-
canBubble- : 是否可以冒泡。设置 Event.bubbles 的值。
-
cancelable- : 是否可以阻止事件默认行为。设置 Event.cancelable 的值。
-
view- : 事件的 AbstractView 对象引用,需要在这里传递 window 对象。设置 UIEvent.view 的值。
-
detail- : 事件的鼠标点击数量。设置 UIEvent.detail 的值。
-
screenX- : 事件的屏幕 x 坐标。设置 MouseEvent.screenX 的值。
-
screenY- : 事件的屏幕 y 坐标。设置 MouseEvent.screenY 的值。
-
clientX- : 事件的客户端 x 坐标。设置 MouseEvent.clientX 的值。
-
clientY- : 事件的客户端 y 坐标。设置 MouseEvent.clientY 的值。
-
ctrlKey- : 事件发生时 <kbd>control</kbd> 键是否被按下。设置 MouseEvent.ctrlKey 的值。
-
altKey- : 事件发生时 <kbd>alt</kbd> 键是否被按下。设置 MouseEvent.altKey 的值。
-
shiftKey- : 事件发生时 <kbd>shift</kbd> 键是否被按下。设置 MouseEvent.shiftKey 的值。
-
metaKey- : 事件发生时 <kbd>meta</kbd> 键是否被按下。设置 MouseEvent.metaKey 的值。
-
button- : 事件的鼠标 MouseEvent.button。
-
relatedTarget- : 事件的相关对象。只在某些事件类型有用(
mouseover和mouseout)。其他的情况下,传递null。
- : 事件的相关对象。只在某些事件类型有用(
返回值
无(undefined)。
示例
const event = document.createEvent("MouseEvents");
event.initMouseEvent(
"click",
true,
true,
window,
0,
0,
0,
80,
20,
false,
false,
false,
false,
0,
null,
);
document.body.dispatchEvent(event);
规范
浏览器兼容性
参见
- MouseEvent.MouseEvent() 构造函数,更标准的创建 MouseEvent 对象方法。
- Event.initEvent() 可以简单达到相同目的的方法。它已过时,不应再使用。
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
