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

Element:transitionend 事件

· 52CE 我爱测

**`transitionend`** 事件会在 CSS 过渡完成的时候触发。如果过渡在完成前就被移除,比如删除 transition-property 或者将 display 设置为 `none`,那么该事件就不会生成。

transitionend 事件会在 CSS 过渡完成的时候触发。如果过渡在完成前就被移除,比如删除 transition-property 或者将 display 设置为 none,那么该事件就不会生成。

transitionend 事件在两个方向上触发:当它完成从初始状态到过渡状态的过渡时,以及当它完全恢复到默认或非过渡状态时。如果没有设置过渡延迟或持续时间,或者两者都是 0 秒或都没有声明,则没有过渡,且不会触发任何过渡事件。如果触发了 transitioncancel 事件,transitionend 事件就不会触发。

这个事件是无法取消的。

语法

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

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

ontransitionend = (event) => {};

事件类型

一个 TransitionEvent,继承自 Event。

TransitionEvent

事件属性

同样继承来自父级 Event 的属性。

  • TransitionEvent.propertyName
    • : 与过渡相关的 CSS 属性名称的字符串。
  • TransitionEvent.elapsedTime
    • : 一个 float 类型的数值,表示在事件触发时过渡已经运行的时间,以秒为单位。该值不受 transition-delay 属性的影响。
  • TransitionEvent.pseudoElement
    • : 一个以 :: 开始的字符串,包含运行动画效果的伪元素名称。如果过渡效果并不是在伪元素上运行的,则该值是空字符串 ''。

示例

下面的代码先获取一个定义了过渡效果的元素,然后添加了一个监听器来监听 transitionend 事件:

const transition = document.querySelector(".transition");

transition.addEventListener("transitionend", () => {
  console.log("过渡结束");
});

使用 ontransitionend 也是一样的:

const transition = document.querySelector(".transition");

transition.ontransitionend = () => {
  console.log("过渡结束");
};

实时示例

在下面的示例中,我们有一个简单的 div 元素,它通过过渡样式进行了修饰,其中包括一个延迟:

<div class="transition">让鼠标在这里悬停</div>
<div class="message"></div>
.transition {
  width: 100px;
  height: 100px;
  background: rgb(255 0 0 / 100%);
  transition-property: transform, background;
  transition-duration: 2s;
  transition-delay: 1s;
}

.transition:hover {
  transform: rotate(90deg);
  background: rgb(255 0 0 / 0%);
}

为此,我们将添加一些 JavaScript 代码来展示 transitionstart、transitionrun、transitioncancel 和 transitionend 事件的触发。在此示例中,如果要取消过渡,则需在过渡结束前不要将鼠标悬停在正在过渡的框上。为了触发过渡结束事件,需要在过渡结束时保持悬停在过渡上。

const message = document.querySelector(".message");
const el = document.querySelector(".transition");

el.addEventListener("transitionrun", () => {
  message.textContent = "触发 transitionrun";
});

el.addEventListener("transitionstart", () => {
  message.textContent = "触发 transitionstart";
});

el.addEventListener("transitioncancel", () => {
  message.textContent = "触发 transitioncancel";
});

el.addEventListener("transitionend", () => {
  message.textContent = "触发 transitionend";
});

实时示例

transitionend 事件会在两个方向上触发:当方框结束旋转并且不透明度达到 0 或 1 时(具体取决于方向)。

如果没有过渡延迟或持续时间,即如果两者都为 0 或未声明,则不会发生过渡,也不会触发任何过渡事件。

如果触发了 transitioncancel 事件,则不会触发 transitionend 事件。

规范

浏览器兼容性

参见

  • TransitionEvent 接口
  • CSS 属性:transition、transition-delay、transition-duration、transition-property、transition-timing-function
  • 相关事件:Element/transitionrun_event、Element/transitionstart_event、Element/transitioncancel_event
  • 以 Document 为目标的该事件:Document/transitionend_event
  • 以 Window 为目标的该事件:Window/transitionend_event

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

资料来源与适用范围

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

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

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