元素:transitioncancel 事件

Baseline 已广泛支持

此功能已经非常成熟,可在多种设备和浏览器版本上使用。自 2020 年 11 月以来,它已在各大浏览器中得到支持。

transitioncancel 事件在 CSS 过渡被取消时触发。

语法

在诸如 addEventListener() 之类的方法中使用事件名称,或设置事件处理程序属性。

js
addEventListener("transitioncancel", (event) => { })

ontransitioncancel = (event) => { }

事件类型

一个 TransitionEvent。继承自 Event

Event TransitionEvent

事件属性

也继承自其父级 Event 的属性.

TransitionEvent.propertyName 只读

一个字符串,包含与过渡关联的 CSS 属性的名称。

TransitionEvent.elapsedTime 只读

一个 float,表示事件触发时过渡已运行的时间(以秒为单位)。此值不受 transition-delay 属性的影响。

TransitionEvent.pseudoElement 只读

一个字符串,以 :: 开头,包含动画运行的 伪元素 的名称。如果过渡未在伪元素上运行,而是在元素上运行,则为空字符串:''

示例

此代码获取一个定义了过渡效果的元素,并为其添加一个 transitioncancel 事件监听器。

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

transition.addEventListener("transitioncancel", () => {
  console.log("Transition canceled");
});

与上面相同,但使用了 ontransitioncancel 属性而不是 addEventListener()

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

transition.ontransitioncancel = () => {
  console.log("Transition canceled");
};

实时示例

在以下示例中,我们有一个简单的 <div> 元素,其样式包含一个带有延迟的过渡。

html
<div class="transition"></div>
<div class="message"></div>
css
.transition {
  width: 100px;
  height: 100px;
  background: red;
  transition-property: transform, background;
  transition-duration: 2s;
  transition-delay: 2s;
}

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

在此基础上,我们将添加一些 JavaScript 来指示 transitionstarttransitionruntransitioncanceltransitionend 事件的触发。在此示例中,要取消过渡,请在过渡结束之前停止将鼠标悬停在正在过渡的框上。要触发过渡结束事件,请将鼠标一直悬停在过渡上直到过渡结束。

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

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

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

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

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

如果 transitionrun 事件发生后、transitionend 事件发生前,过渡在任何方向上被取消,则会触发 transitioncancel 事件。

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

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

规范

规范
CSS 过渡
# transitioncancel
CSS 过渡
# dom-globaleventhandlers-ontransitioncancel

浏览器兼容性

另见