AnimationEffect: getComputedTiming() メソッド

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨2020年3月⁩.

getComputedTiming() は AnimationEffect インターフェイスのメソッドで、このアニメーション効果のタイミングのプロパティの計算値を返します。

メモ: これらの値は、 window.getComputedStyle(elem) を使用して返される要素のスタイルの計算値と同等です。

構文

getComputedTiming()

引数

なし。

返値

以下のものを含むオブジェクトです。

AnimationEffect.getTiming() が返すオブジェクトのすべてのプロパティ。ただし、 "auto" 値は AnimationEffect の種類に依存する計算値で置き換えられます。
さらに以下のプロパティがあります。

endTime

効果の開始時点からの終了時刻をミリ秒単位で示す number です。これは activeDuration に delay と endDelay を足した値になります。

activeDuration

効果のすべての反復処理の合計時間をミリ秒単位で示す number です。これは duration に iterations を掛けたものです（その積が NaN となる場合はゼロ）。

localTime

number または null です。

その効果が実行される時間をミリ秒単位で示します。これは関連するアニメーションの currentTime と等しく、効果がアニメーションに関連付けられていない場合は null となります。

progress

null または number で、 0 以上 1 未満です。

効果の現在の反復処理の進行状況を示します。 activeDuration の開始時点では、iterationStart の小数部と等しくなります。

例えば、効果が delay または endDelay の期間中であったり、効果が完了していたり、 localTime が null であるなど、反復処理の途中でない場合に null を返します。

currentIteration

null または整数の number です。

現在の反復処理のインデックスを示します。 activeDuration の開始時点では、 iterationStart の整数部と等しくなります。

progress が null ならば常に null です。