W3cubDocs

/DOM

Web Animations API

This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The Web Animations API allows for synchronizing and timing changes to the presentation of a Web page, i.e. animation of DOM elements. It does so by combining two models: the Timing Model and the Animation Model.

Concepts and usage

The Web Animations API provides a common language for browsers and developers to describe animations on DOM elements. To get more information on the concepts behind the API and how to use it, read Using the Web Animations API.

Web Animations interfaces

Animation
Provides playback controls and a timeline for an animation node or source. Can take an object created with the KeyframeEffect() constructor.
KeyframeEffect
Describes sets of animatable properties and values, called keyframes and their timing options. These can then be played using the Animation() constructor.
AnimationTimeline
Represents the timeline of animation. This interface exists to define timeline features (inherited by DocumentTimeline and future timeline objects) and is not itself accessed by developers.
AnimationEvent
Actually part of CSS Animations.
DocumentTimeline
Represents animation timelines, including the default document timeline (accessed using the Document.timeline property).
EffectTiming
Element.animate(), KeyframeEffectReadOnly.KeyframeEffectReadOnly(), and KeyframeEffect.KeyframeEffect() all accept an optional dictionary object of timing properties.

Extensions to other interfaces

The Web Animations API adds some new features to document and element.

Extensions to the Document interface

document.timeline
The DocumentTimeline object representing the default document timeline.
document.getAnimations()
Returns an Array of Animation objects currently in effect on elements in the document.

Extensions to the Element interface

Element.animate()
A shortcut method for creating and playing an animation on an element. It returns the created Animation object instance.

Web Animations read-only interfaces

The following interfaces are included in the spec for purposes such as defining features used in multiple other places, or to serve as bases for multiple interfaces which can all be used as values of the same properties. You wouldn't directly use these in web development work, but they may be interesting for library authors to understand how the technology works so their implementations can be more effective, or for browser engineers looking for an easier reference than the spec provides.

AnimationEffectTimingReadOnly
A dictionary object of timing properties, which are inherited by the mutable AnimationEffectTiming interface associated with KeyframeEffect.
AnimationEffectReadOnly
Defines current and future "Animation Effects" like KeyframeEffect, which can be passed to Animation objects for playing, and KeyframeEffectReadOnly which is used by KeyframeEffect (inherited by CSS Animations and Transitions). All values of Animation.effect are of types based on AnimationEffectReadOnly.
KeyframeEffectReadOnly
Describes sets of animatable properties and values that can be played using the Animation() constructor, and which are inherited by KeyframeEffect.

Specifications

Specification Status Comment
Web Animations Working Draft Initial definition

See also

Edit this page on MDN

© 2005–2018 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Web_Animations_API