This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for usage in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the specification changes.
The Animation.timeline
property of the Animation
interface returns or sets the timeline
associated with this animation. A timeline is a source of time values for synchronization purposes, and is an AnimationTimeline
-based object. By default, the animation's timeline and the Document
's timeline are the same.
Syntax
var animationsTimeline = Animation.timeline; Animation.timeline = newTimeline;
Value
A timeline object to use as the timing source for the animation, or null
to use the default, which is the Document
's timeline.
Examples
Here we set the animation's timeline to be the same as the document's timeline (this is the default timeline for all animations, by the way):
animation.timeline = document.timeline;
Specifications
Specification | Status | Comment |
---|---|---|
Web Animations The definition of 'Animation.timeline' in that specification. |
Working Draft | Editor's draft. |
Browser compatibility
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|
Basic support | No support | 48 (48)[1] | No support | No support | No support |
Feature | Android | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|
Basic support | No support | 48.0 (48)[1] | No support | No support | No support |
[1] The Web Animations API is only enabled by default in Firefox Developer Edition and Nightly builds. You can enable it in beta and release builds by setting the preference dom.animations-api.core.enabled
to true
, and can disable it in any Firefox version by setting this preference to false
.
See also
- Web Animations API
Animation
AnimationTimeline
the parent object all timelines inherit from.DocumentTimeline
the only kind of timeline object available at this time.Document.timeline
is the default timeline all animations are assigned.