Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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

js
updateTiming(timing)

Parameter

timing Optional

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.

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

Spezifikationen

Spezifikation
Web Animations
# dom-animationeffect-updatetiming

Browser-Kompatibilität

Siehe auch