AnimationEffect: updateTiming() メソッド
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2020年3月以降、すべてのブラウザーで利用可能です。
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
仕様書
| 仕様書 |
|---|
| Web Animations # dom-animationeffect-updatetiming |