Animation.oncancel - Web API 接口参考 编辑

这是一个实验中的功能
此功能某些浏览器尚在开发中，请参考浏览器兼容性表格以得到在不同浏览器中适合使用的前缀。由于该功能对应的标准文档可能被重新修订，所以在未来版本的浏览器中该功能的语法和行为可能随之改变。

Web Animations API 的 Animation 接口的 oncancel 属性是 cancel 事件的事件处理程序。

当动作从其他状态进入 "idle" 播放状态，例如当动画在结束播放后从元素中移除时，cancel 事件可以 Animation.cancel() 被手动触发。 

在新的动画中，创建一个新的初始的空闲动画不会触发 cancel 事件。

语法

var cancelHandler = Animation.oncancel;

Animation.oncancel = cancelHandler;

值

当动画被取消时，这个函数将会被执行。默认是 null 。

例子

如果动画被取消，将会从元素中移除它。

animation.oncancel = animation.effect.target.remove();

标准

标准	状态	备注
Web Animations Animation.oncancel	Working Draft	编辑草案中。

浏览器兼容性

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

• Desktop
• Mobile

功能	Chrome	Firefox (Gecko)	Internet Explorer	Opera	Safari (WebKit)
基础支持	39.0	48 (48)[1]	未实现	未实现	未实现

功能	Android	Firefox Mobile (Gecko)	IE Phone	Opera Mobile	Safari Mobile
基础支持	(Yes)	48.0 (48)[1]	未实现	未实现	未实现

[1] Web Animations API 默认在 Firefox Developer Edition 和 Nightly builds 被启用。你可以在设置属性 dom.animations-api.core.enabled 为 true 时在 Beta 和 发行版 开启这个功能，你可以设置为 false 来禁用这个功能。

参见

• Web Animations API
• Animation
• cancel 事件