AnimationEffect: updateTiming()-Methode
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 Methode updateTiming() der Schnittstelle AnimationEffect aktualisiert die angegebenen Timing-Eigenschaften eines Animationseffekts.
Syntax
updateTiming(timing)
Parameter
timingOptional-
Ein Objekt mit keiner oder mehreren Eigenschaften aus dem Rückgabewert von
AnimationEffect.getTiming(), die festlegen, welche Timing-Eigenschaften aktualisiert werden sollen.
Rückgabewert
Keiner (undefined).
Ausnahmen
TypeError-
Wird ausgelöst, wenn für eine der Timing-Eigenschaften ungültige Werte angegeben werden.
Beispiele
>Nebeneffekte
updateTiming() kann dazu führen, dass eine zugehörige Animation die Wiedergabe beginnt oder beendet. Dies ist beispielsweise der Fall, wenn der Effekt einer laufenden Animation so verkürzt wird, dass seine Endzeit vor Animation.currentTime liegt, oder wenn der Effekt einer abgeschlossenen Animation so verlängert wird, dass seine Endzeit nach Animation.currentTime liegt.
const animation = document.body.animate([], { duration: 1000 });
animation.finish();
console.log(animation.playState); // finished
animation.effect.updateTiming({ duration: 2000 });
console.log(animation.playState); // running
Spezifikationen
| Spezifikation |
|---|
| Web Animations> # dom-animationeffect-updatetiming> |