AnimationEffect: updateTiming() メソッド

Baseline 2022

Newly available

Since September 2022, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

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

関連情報