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

Element:transitionrun 事件

· 52CE 我爱测

**`transitionrun`** 事件会在 CSS 过渡首次创建时触发,也即在任何 transition-delay 开始之前。

transitionrun 事件会在 CSS 过渡首次创建时触发,也即在任何 transition-delay 开始之前。

此事件不可取消。

语法

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

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

ontransitionrun = (event) => { }

事件类型

TransitionEvent。继承自 Event。

TransitionEvent

示例

以下代码为 transitionrun 事件添加监听器:

el.addEventListener("transitionrun", () => {
  console.log("过渡正在运行,但不一定已经开始实际过渡");
});

同样的效果,但使用 ontransitionrun 属性而非 addEventListener():

el.ontransitionrun = () => {
  console.log("过渡已开始运行,并将在过渡延迟结束后开始实际过渡");
};

运行实例

在下面的示例中,我们有一个简单的 div 元素,并为其设置了包含延迟的过渡样式:

<div class="transition">将鼠标悬停在我上方</div>
<div class="message"></div>
.transition {
  width: 100px;
  height: 100px;
  background: red;
  transition-property: transform, background;
  transition-duration: 2s;
  transition-delay: 1s;
}

.transition:hover {
  transform: rotate(90deg);
  background: transparent;
}

对此,我们再添加一些 JavaScript,以标明 Element/transitionstart_event 和 transitionrun 事件在何处触发。

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

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

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

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

运行实例

二者的区别在于:

  • transitionrun 在过渡创建时触发(即在任意延迟开始时)。
  • transitionstart 在实际动画开始时触发(即在任意延迟结束时)。

即使过渡在延迟到期前被取消,仍会触发 transitionrun。若没有过渡延迟,或 transition-delay 为负值,则会同时触发 transitionrun 和 transitionstart。

规范

浏览器兼容性

参见

  • TransitionEvent 接口
  • CSS 属性:transition、transition-delay、transition-duration、transition-property、transition-timing-function
  • 相关事件:Element/transitionend_event、Element/transitionstart_event、Element/transitioncancel_event

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

资料来源与适用范围

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

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

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