AnimationEffect: updateTiming() Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨März 2020⁩.

Die updateTiming()-Methode der AnimationEffect-Schnittstelle aktualisiert die angegebenen Zeiteigenschaften für einen Animationseffekt.

Syntax

updateTiming(timing)

Parameter

timing Optional: Ein Objekt, das null oder mehr der Eigenschaften aus dem Rückgabewert von AnimationEffect.getTiming() enthält, die die zu aktualisierenden Zeiteigenschaften darstellen.

Ausnahmen

TypeError: Wird ausgelöst, wenn ungültige Werte für eine der Zeiteigenschaften angegeben werden.

updateTiming() kann dazu führen, dass eine zugehörige Animation beginnt oder aufhört zu spielen, wenn beispielsweise der Effekt einer laufenden Animation verkürzt wird, sodass seine Endzeit vor der Animation.currentTime liegt oder der Effekt einer beendeten Animation verlängert wird, sodass seine Endzeit nach der 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