Animation
Web Animations API 中的 Animation 接口代表一个单独的动画播放器,并为动画节点或源提供播放控件和时间线。
构造函数
Animation()-
创建一个新的
Animation对象实例。
实例属性
Animation.currentTime-
动画的当前时间值,以毫秒为单位,无论是正在运行还是已暂停。如果动画没有
timeline,处于非活动状态或尚未播放,其值为null。 Animation.effect-
获取和设置与此动画关联的
AnimationEffect。这通常是一个KeyframeEffect对象。 Animation.finished只读-
返回此动画当前的完成 Promise。
Animation.id-
获取和设置用于标识动画的
String。 Animation.overallProgress只读-
返回一个介于
0和1之间的数字,表示动画在其完成状态下的总体进度。 Animation.pending只读-
指示动画当前是否正在等待异步操作,例如发起播放或暂停正在运行的动画。
Animation.playState只读-
返回一个描述动画播放状态的枚举值。
Animation.playbackRate-
获取或设置动画的播放速率。
Animation.ready只读-
返回此动画当前的就绪 Promise。
Animation.replaceState只读-
指示动画是活动的、在被另一个动画替换后被自动移除,还是通过调用
Animation.persist()被显式保留。 Animation.startTime-
获取或设置动画播放应开始的预定时间。
Animation.timeline-
获取或设置与此动画关联的
timeline。
实例方法
Animation.cancel()-
清除由此动画引起的
keyframeEffects并中止其播放。 Animation.commitStyles()-
将动画的当前样式状态提交给正在动画的元素,即使该动画已被移除。它将导致当前样式状态以
style属性中属性的形式写入正在动画的元素。 Animation.finish()-
根据动画是正在播放还是正在反向播放,将动画定位到其一端。
Animation.pause()-
暂停动画的播放。
Animation.persist()-
显式保留一个动画,防止它在另一个动画替换它时被 自动移除。
Animation.play()-
开始或恢复动画的播放,或者在动画之前完成的情况下重新开始动画。
Animation.reverse()-
反转播放方向,停在动画的开头。如果动画已完成或未播放,它将从末尾播放到开头。
Animation.updatePlaybackRate()-
在首次同步其播放位置后设置动画的速度。
事件
cancel-
当调用
Animation.cancel()方法或动画从另一个状态进入"idle"播放状态时触发。 finish-
动画播放完成时触发。
remove-
动画被浏览器 自动移除 时触发。
可访问性考虑
闪烁和动画可能会给患有注意力缺陷多动障碍 (ADHD) 等认知问题的人带来困扰。此外,某些类型的运动可能会触发前庭障碍、癫痫和偏头痛以及瞳孔敏感性。
考虑提供暂停或禁用动画的机制,并使用 Reduced Motion Media Query(或等效的 用户代理客户端提示 Sec-CH-Prefers-Reduced-Motion)为已表示偏好无动画体验的用户创建互补体验。
规范
| 规范 |
|---|
| Web 动画 # the-animation-interface |
浏览器兼容性
加载中…