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 March 2020.

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

Syntax

js
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.

Rückgabewert

Keiner (undefined).

Ausnahmen

TypeError

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

Beispiele

Seiteneffekte

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.

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

Specification
Web Animations
# dom-animationeffect-updatetiming

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch