AnimationEffect: Methode getComputedTiming()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit März 2020 browserübergreifend verfügbar.
Die getComputedTiming()-Methode der AnimationEffect-Schnittstelle gibt die berechneten Timing-Eigenschaften für diesen Animationseffekt zurück.
Hinweis:
Diese Werte sind vergleichbar mit den berechneten Stilen eines Elements, die mit window.getComputedStyle(elem) zurückgegeben werden.
Syntax
getComputedTiming()
Parameter
Keine.
Rückgabewert
Ein Objekt, welches enthält:
- alle Eigenschaften des Objekts, das von
AnimationEffect.getTiming()zurückgegeben wird, außer dass alle"auto"-Werte durch berechnete Werte ersetzt werden, die möglicherweise vom Typ desAnimationEffectabhängen. - die folgenden zusätzlichen Eigenschaften:
endTime-
Eine
Zahl, die die Endzeit des Effekts in Millisekunden ab dem Start des Effekts angibt. Dies ist gleichactiveDurationplusdelayundendDelay. activeDuration-
Eine
Zahl, die die gesamte Dauer in Millisekunden aller Iterationen des Effekts angibt. Dies ist gleichdurationmultipliziert mititerations(oder null, wenn das ProduktNaNwäre). localTime-
Eine
Zahlodernull.Gibt die Länge der Zeit in Millisekunden an, die der Effekt gelaufen ist. Dies ist gleich der
currentTimeder zugehörigen Animation odernull, wenn der Effekt nicht mit einer Animation verbunden ist. progress-
nulloder eineZahl.Gibt den Fortschritt des Effekts durch seine aktuelle Iteration an. Zu Beginn der
activeDurationentspricht dies dem Bruchteil voniterationStart.Der Wert liegt typischerweise zwischen
0und1, kann aber außerhalb dieses Bereichs liegen, abhängig vom Output der<easing-function>des Effekts. Zum Beispiel würde einecubic-bezier(0.3, 2, 0.6, 2)-Funktion den Zeitfortschritt von0.5auf ungefähr1.65transformieren.Gibt
nullzurück, wenn der Effekt nicht mitten in einer Iteration ist, zum Beispiel weil der Effekt sich in dendelay- oderendDelay-Perioden befindet, der Effekt beendet ist oderlocalTimenullist. currentIteration-
nulloder eine ganzeZahl.Gibt den Index der aktuellen Iteration an. Zu Beginn der
activeDurationentspricht dies dem ganzzahligen Teil voniterationStart.Gibt
nullzurück, wenn immerprogressnullist.
Spezifikationen
| Spezifikation |
|---|
| Web Animations> # dom-animationeffect-getcomputedtiming> |