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

瀏覽器相容性

另見