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

Element:mouseout 事件

· 52CE 我爱测

**`mouseout`** 事件在定点设备(通常是鼠标)移动至Element或其子元素之外时,会在该元素上触发。

mouseout 事件在定点设备(通常是鼠标)移动至Element或其子元素之外时,会在该元素上触发。

当指针从一个元素移入其子元素时,因为子元素遮盖了父元素的可视区域,所以 mouseout 也会被触发。

语法

在类似 EventTarget.addEventListener 这样的方法中使用事件名称,或者设置事件处理器属性。

addEventListener("mouseout", (event) => {});

onmouseout = (event) => {};

事件类型

一个 MouseEvent。继承自 Event。

MouseEvent

事件属性

这个接口也继承其父接口 UIEvent 和 Event 的属性。

  • MouseEvent.altKey
    • : 当鼠标事件被触发时,如果 <kbd>alt</kbd> 键已被按下,返回 true。
  • MouseEvent.button
    • : 触发鼠标事件时,按下按钮的编号(如果适用)。
  • MouseEvent.buttons
    • : 触发鼠标事件时,按下的按钮(如果存在)。
  • MouseEvent.clientX
    • : 鼠标指针相对于局部 DOM 元素的 X 轴坐标。
  • MouseEvent.clientY
    • : 鼠标指针相对于局部 DOM 元素的 Y 轴坐标。
  • MouseEvent.ctrlKey
    • : 当鼠标事件被触发时,如果 <kbd>control</kbd> 键已被按下,返回 true。
  • MouseEvent.layerX
    • : 返回事件相对于当前层的水平坐标。
  • MouseEvent.layerY
    • : 返回事件相对于当前层的垂直坐标。
  • MouseEvent.metaKey
    • : 当鼠标事件被触发时,如果 <kbd>meta</kbd> 键已被按下,返回 true。
  • MouseEvent.movementX
    • : 鼠标指针相对于最后一次 Element/mousemove_event 事件位置的 X 轴坐标。
  • MouseEvent.movementY
    • : 鼠标指针相对于最后一次 Element/mousemove_event 事件位置的 Y 轴坐标。
  • MouseEvent.offsetX
    • : 鼠标指针相对于目标节点的内填充边的 X 轴坐标。
  • MouseEvent.offsetY
    • : 鼠标指针相对于目标节点的内填充边的 Y 轴坐标。
  • MouseEvent.pageX
    • : 鼠标指针相对于整个文档的 X 轴坐标。
  • MouseEvent.pageY
    • : 鼠标指针相对于整个文档的 Y 轴坐标。
  • MouseEvent.relatedTarget
    • : 事件的次要目标(如果存在)。
  • MouseEvent.screenX
    • : 鼠标指针相对于屏幕的 X 轴坐标。
  • MouseEvent.screenY
    • : 鼠标指针相对于屏幕的 Y 轴坐标。
  • MouseEvent.shiftKey
    • : 当鼠标事件被触发时,如果 <kbd>shift</kbd> 键已被按下,返回 true。
  • MouseEvent.mozInputSource
    • : 生成事件的设备类型(MOZ_SOURCE_* 常量之一)。例如,这允许你决定鼠标事件是否由实际的鼠标还是触摸事件生成(这可能会在一定程度影响你对事件相关坐标判断的准确性)。
  • MouseEvent.webkitForce
    • : 单击时施加的压力大小。
  • MouseEvent.x
    • : MouseEvent.clientX 的别名。
  • MouseEvent.y
    • : MouseEvent.clientY 的别名。

示例

以下示例将说明如何使用 mouseout 事件。

mouseout 和 mouseleave

以下示例说明了 mouseout 和 Element/mouseleave_event 事件的区别。为 ul 添加 mouseleave 事件,以在鼠标离开 <ul> 元素时将列表变成紫色。添加 mouseout 事件,以在鼠标移出目标元素时将目标元素变成橙色。

当你尝试的时候,你会发现 mouseout 被添加到单个列表项目上,而 mouseleave 则应用于整个列表,这取决于列表项目的层次关系,而列表项目遮盖了底层的 <ul>。

HTML

<ul id="test">
  <li>item 1</li>
  <li>item 2</li>
  <li>item 3</li>
</ul>

JavaScript

const test = document.getElementById("test");

// 当鼠标移出 <ul> 元素时,短暂地将列表变成紫色
test.addEventListener(
  "mouseleave",
  (event) => {
    // 高亮 mouseleave 的目标
    event.target.style.color = "purple";

    // 延迟一秒后重置颜色
    setTimeout(() => {
      event.target.style.color = "";
    }, 1000);
  },
  false,
);

// 当鼠标离开 <li> 元素时,短暂地将其变成橙色
test.addEventListener(
  "mouseout",
  (event) => {
    // 高亮 mouseout 的目标
    event.target.style.color = "orange";

    // 延迟 500ms 后重置颜色
    setTimeout(() => {
      event.target.style.color = "";
    }, 500);
  },
  false,
);

结果

mouseout 和 mouseleave

规范

浏览器兼容性

参见

  • 事件介绍
  • Element/mousedown_event
  • Element/mouseup_event
  • Element/mousemove_event
  • Element/click_event
  • Element/dblclick_event
  • Element/mouseover_event
  • Element/mouseenter_event
  • Element/mouseleave_event
  • Element/contextmenu_event

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

资料来源与适用范围

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

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

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