Animation: Animation() constructor
The Animation()
constructor of the Web Animations API returns a new Animation
object instance.
Syntax
js
new Animation()
new Animation(effect)
new Animation(effect, timeline)
Parameters
effect
Optional-
The target effect, as an object based on the
AnimationEffect
interface, to assign to the animation. Although in the future other effects such asSequenceEffect
s orGroupEffect
s might be possible, the only kind of effect currently available isKeyframeEffect
. This can benull
(which is the default) to indicate that there should be no effect applied. timeline
Optional-
Specifies the
timeline
with which to associate the animation, as an object of a type based on theAnimationTimeline
interface. Currently the only timeline type available isDocumentTimeline
, but in the future there may be timelines associated with gestures or scrolling, for example. The default value isDocument.timeline
, but this can be set tonull
as well.
Examples
In the Follow the White Rabbit example, the Animation()
constructor is used to create an Animation
for the rabbitDownKeyframes
using the document's timeline
:
js
const rabbitDownAnimation = new Animation(
rabbitDownKeyframes,
document.timeline
);
Specifications
Specification |
---|
Web Animations # dom-animation-animation |
Browser compatibility
BCD tables only load in the browser