大网数据广告活动
Web 标准与前端开发

鼠标事件

· 52CE 我爱测

`MouseEvent`** 接口指用户与指针设备(如鼠标)交互时发生的事件。使用此接口的常见事件包括:`click`、`dblclick`、`mouseup`、`mousedown`。

UI Events

MouseEvent 接口指用户与指针设备(如鼠标)交互时发生的事件。使用此接口的常见事件包括:click、dblclick、mouseup、mousedown。

MouseEvent 派生自 UIEvent,UIEvent 派生自 Event。虽然 MouseEvent.initMouseEvent() 方法保持向后兼容性,但是应该使用 MouseEvent() 构造函数创建一个 MouseEvent 对象。

一些具体的事件都派生自 MouseEvent:WheelEvent 和DragEvent。

构造函数

  • MouseEvent.MouseEvent
    • : 创建一个新的 MouseEvent 对象。

静态属性

  • MouseEvent.WEBKIT_FORCE_AT_MOUSE_DOWN_static
    • : 正常点击所需的最小力量。
  • MouseEvent.WEBKIT_FORCE_AT_FORCE_MOUSE_DOWN_static
    • : “用力点按”所需的最小力量。

实例属性

这个接口也从父接口 UIEvent 和 Event 继承了属性。

  • MouseEvent.altKey
    • : 当鼠标事件触发时,如果 <kbd>alt</kbd> 键被按下,返回 true。
  • MouseEvent.button
    • : 当鼠标事件触发时,如果鼠标按钮被按下(如果有的话),将会返回一个数值。
  • MouseEvent.buttons
    • : 当鼠标事件触发时,如果多个鼠标按钮被按下(如果有的话),将会返回一个或者多个代表鼠标按钮的数字。
  • MouseEvent.clientX
  • MouseEvent.clientY
  • MouseEvent.ctrlKey
    • : 当鼠标事件触发时,如果 <kbd>control</kbd> 键被按下,则返回 true。
  • MouseEvent.metaKey
    • : 当鼠标事件触发时,如果 <kbd>meta</kbd> 键被按下,则返回 true。
  • MouseEvent.movementX
    • : 鼠标指针相对于最后mousemove事件位置的 X 坐标。
  • MouseEvent.movementY
    • : 鼠标指针相对于最后mousemove事件位置的 Y 坐标。
  • MouseEvent.offsetX
    • : 鼠标指针相对于目标节点内边位置的 X 坐标。
  • MouseEvent.offsetY
    • : 鼠标指针相对于目标节点内边位置的 Y 坐标。
  • MouseEvent.pageX
    • : 鼠标指针相对于整个文档的 X 坐标。
  • MouseEvent.pageY
    • : 鼠标指针相对于整个文档的 Y 坐标。
  • MouseEvent.region
    • : 返回被点击事件影响的点击区域的 id,如果没有区域被影响则返回 null。
  • MouseEvent.relatedTarget
    • : 鼠标事件的次要目标(如果有的话)。
  • MouseEvent.screenX
    • : 鼠标指针相对于全局(屏幕)的 X 坐标。
  • MouseEvent.screenY
    • : 鼠标指针相对于全局(屏幕)的 Y 坐标。
  • MouseEvent.shiftKey
    • : 当鼠标事件触发时,如果 <kbd>shift</kbd> 键被按下,则返回 true。
  • MouseEvent.which
    • : 当鼠标事件触发时,表示被按下的按钮。
  • MouseEvent.mozInputSource
    • : 生成事件的类型(若干 MOZ_SOURCE_*常量如下列出)。可通过该属性获知鼠标事件是否由真实鼠标设备触发,亦或通过触摸事件触发(这可能影响处理坐标事件时的精确程度)。
  • MouseEvent.webkitForce
    • : 点击时施加的压力量。
  • MouseEvent.x
    • : MouseEvent.clientX 的别名。
  • MouseEvent.y
    • : MouseEvent.clientY 的别名。

实例方法

这个接口也从父接口 UIEvent 和 Event 继承了方法。

  • MouseEvent.getModifierState()
    • : 返回指定修饰键的当前状态。请参照 KeyboardEvent.getModifierState 查看详情。
  • MouseEvent.initMouseEvent()
    • : 初始化创建 MouseEvent 的值。如果这个事件已经被派发,这个方法将不会做任何事情。

示例

这个例子演示了使用 DOM 方法在复选框上模拟一个点击事件(使用编程的方式生成点击事件)。

HTML

<p>
  <label><input type="checkbox" id="checkbox" /> 已点击</label>
</p>
<p>
  <button id="button">点击我,向复选框发送一个 MouseEvent</button>
</p>

JavaScript

function simulateClick() {
  // 获取要发送 click 事件的元素
  const cb = document.getElementById("checkbox");

  // 创建一个合成的 click MouseEvent
  let evt = new MouseEvent("click", {
    bubbles: true,
    cancelable: true,
    view: window,
  });

  // 向复选框元素发送事件
  cb.dispatchEvent(evt);
}
document.getElementById("button").addEventListener("click", simulateClick);

结果

示例

规范

浏览器兼容性

参考

  • 它的直接父级,UIEvent。

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。