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 March 2020.
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
です。
仕様書
Specification |
---|
Web Animations # dom-animationeffect-getcomputedtiming |
ブラウザーの互換性
BCD tables only load in the browser