动画效果：updateTiming() 方法

基线 广泛可用

此功能已经成熟，并在许多设备和浏览器版本上都能正常使用。它在以下时间已在所有浏览器中可用： 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

浏览器兼容性

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

另请参阅