AnimationEffect: updateTiming() 方法

Baseline 已广泛支持

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

AnimationEffect 接口的 updateTiming() 方法用于更新动画效果的指定计时属性。

语法

js
updateTiming(timing)

参数

timing 可选

一个对象,包含零个或多个来自 AnimationEffect.getTiming() 返回值的属性,表示要更新的计时属性。

返回值

无(undefined)。

异常

TypeError

如果为任何计时属性提供了无效值,则抛出异常。

示例

副作用

updateTiming() 可能会导致任何相关的 Animation 开始或停止播放。例如,如果正在播放的动画效果被缩短,使其结束时间在 Animation.currentTime 之前;或者如果已结束的动画效果被延长,使其结束时间在 Animation.currentTime 之后。

js
const animation = document.body.animate([], { duration: 1000 });
animation.finish();
console.log(animation.playState); // finished
animation.effect.updateTiming({ duration: 2000 });
console.log(animation.playState); // running

规范

规范
Web 动画
# dom-animationeffect-updatetiming

浏览器兼容性

另见