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

Element:mouseleave 事件

· 52CE 我爱测

`mouseleave`** 事件在定点设备(通常是鼠标)的光标移出 Element 时,会在该元素上触发。

UI Events

mouseleave 事件在定点设备(通常是鼠标)的光标移出 Element 时,会在该元素上触发。

mouseleave 与 Element/mouseout_event 相似,但区别在于 mouseleave 不会冒泡,而 mouseout 会冒泡。这意味着当指针已离开该元素及其所有后代时,会触发 mouseleave;而由于冒泡,当指针离开该元素或离开该元素的某个后代时(即使指针仍在该元素内),也会触发 mouseout。除此之外,在同一情形下,leave 与 out 事件会在适当时同时派发。

当元素被替换或从 DOM 中移除时,不会触发 mouseleave 和 mouseout 事件。

请注意,「移出某个元素」指的是元素在 DOM 树中的位置,而不是其视觉位置。例如,若两个兄弟元素的定位使其中一个位于另一个内部,则从外部元素移入内部元素会在外部元素上触发 mouseleave,即使指针仍位于外部元素的边界内。

语法

在诸如 EventTarget.addEventListener 等方法中使用事件名称,或设置事件处理器属性。

addEventListener("mouseleave", (event) => { })

onmouseleave = (event) => { }

事件类型

MouseEvent。继承自 UIEvent 和 Event。

MouseEvent

描述

mouseleave 事件的行为

mouseleave 行为示意图

离开层次结构中的各个元素时,会向每个元素发送一个 mouseleave 事件。此处,当指针从文本移到图中最外层 div 之外的区域时,会向层次结构中的四个元素发送四个事件。

mouseout 事件的行为

mouseout 行为示意图

单个 mouseout 事件会发送到 DOM 树中最深的元素,然后沿层次结构向上冒泡,直到被处理器取消或到达根元素。

示例

mouseout 文档中有一个示例,说明了 mouseout 与 mouseleave 的区别。

mouseleave

以下简单示例使用 mouseenter 事件,在鼠标进入分配给 <div> 的区域时更改其边框。然后向列表添加一项,并带上 mouseenter 或 mouseleave 事件的编号。

HTML

<div id="mouseTarget">
  <ul id="unorderedList">
    <li>还没有事件!</li>
  </ul>
</div>

CSS

为 <div> 添加样式,使其更易辨认。

#mouseTarget {
  box-sizing: border-box;
  width: 15rem;
  border: 1px solid #333333;
}

JavaScript

let enterEventCount = 0;
let leaveEventCount = 0;
const mouseTarget = document.getElementById("mouseTarget");
const unorderedList = document.getElementById("unorderedList");

mouseTarget.addEventListener("mouseenter", (e) => {
  mouseTarget.style.border = "5px dotted orange";
  enterEventCount++;
  addListItem(`这是 mouseenter 事件 ${enterEventCount}。`);
});

mouseTarget.addEventListener("mouseleave", (e) => {
  mouseTarget.style.border = "1px solid #333333";
  leaveEventCount++;
  addListItem(`这是 mouseleave 事件 ${leaveEventCount}。`);
});

function addListItem(text) {
  // 使用提供的文本创建一个新的文本节点
  const newTextNode = document.createTextNode(text);

  // 创建一个新的 li 元素
  const newListItem = document.createElement("li");

  // 将文本节点添加到 li 元素
  newListItem.appendChild(newTextNode);

  // 将新创建的列表项添加到列表
  unorderedList.appendChild(newListItem);
}

结果

mouseleave

规范

浏览器兼容性

参见

  • 学习:事件介绍
  • Element/mousedown_event
  • Element/mouseup_event
  • Element/mousemove_event
  • Element/click_event
  • Element/dblclick_event
  • Element/mouseover_event
  • Element/mouseout_event
  • Element/mouseenter_event
  • Element/contextmenu_event
  • Element/pointerleave_event

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

资料来源与适用范围

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

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

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