Animation:cancel 事件

Baseline 已广泛支持

此功能已经成熟,并可在许多设备和浏览器版本上使用。自 ⁨2020 年 3 月⁩起,它已在各浏览器中推出。

cancel 事件是 Animation 接口的一部分,当调用 Animation.cancel() 方法时,或当动画从其他状态进入 "idle"(空闲)播放状态时(例如,当动画在播放完成前从元素中移除时),就会触发此事件。

注意: 创建一个初始状态为空闲的新动画不会在其上触发 cancel 事件。

语法

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

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

oncancel = (event) => { }

事件类型

一个 AnimationPlaybackEvent 对象。继承自 Event

Event AnimationPlaybackEvent

事件属性

除了下面列出的属性之外,父接口 Event 的属性也可使用。

AnimationPlaybackEvent.currentTime 只读

生成事件的动画的当前时间。

AnimationPlaybackEvent.timelineTime 只读

生成事件的动画的时间线时间值。

示例

如果此动画被取消,则移除其元素。

js
animation.oncancel = (event) => {
  animation.effect.target.remove();
};

规范

规范
Web 动画
# dom-animation-oncancel
Web 动画
# cancel-event

浏览器兼容性

另见