AnimationEffect: updateTiming() メソッド
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2020.
updateTiming()
は AnimationEffect
インターフェイスのメソッドで、アニメーション効果の指定した時刻プロパティを更新します。
構文
js
updateTiming(timing)
引数
timing
省略可-
更新するタイミングプロパティを表す、
AnimationEffect.getTiming()
の返値に含まれるプロパティを 0 個以上格納したオブジェクトです。
返値
なし (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
仕様書
Specification |
---|
Web Animations # dom-animationeffect-updatetiming |
ブラウザーの互換性
BCD tables only load in the browser