动画:取消事件

基线 广泛可用

此功能已经很完善,并且可以在许多设备和浏览器版本中使用。它从以下版本开始在各浏览器中可用: 2020 年 3 月.

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

注意: 创建一个最初处于空闲状态的新动画不会在该新动画上触发 cancel 事件。

语法

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

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

事件类型

事件属性

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

AnimationPlaybackEvent.currentTime 只读

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

AnimationPlaybackEvent.timelineTime 只读

生成该事件的动画的时间轴的时间值。

示例

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

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

规范

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

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅