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.
var keyframes = new keyframeEffectReadOnly(element, keyframeSet, keyframeOptions); var keyframes = new keyframeEffectReadOnly(sourceKeyFrames);
The first type of constructor (see above) creates a completely new
KeyframeEffectReadOnly object instance. Its parameters are:
- The DOM element to be animated, or
- A keyframe object or
- keyframeOptions Optional
- Either an integer representing the animation's duration (in milliseconds), or an
Objectcontaining one or more of the following:
- The number of milliseconds to delay the start of the animation. Defaults to 0.
- Whether the animation runs forwards (
normal), backwards (
reverse), switches direction after each iteration (
alternate), or runs backwards and switches direction after each iteration (
alternate-reverse). Defaults to
- The number of milliseconds each iteration of the animation takes to complete. Defaults to 0. Although this is technically optional, keep in mind that your animation will not run if this value is 0.
- The rate of the animation's change over time. Accepts the pre-defined values
"ease-in-out", or a custom
"cubic-bezier(0.42, 0, 0.58, 1)". Defaults to
- The number of milliseconds to delay after the end of an animation. This is primarily of use when sequencing animations based on the end time of another animation. Defaults to 0.
- Dictates whether the animation's effects should be reflected by the element(s) prior to playing (
"backwards"), retained after the animation has completed playing (
both. Defaults to
- Describes at what point in the iteration the animation should start. 0.5 would indicate starting halfway through the first iteration for example, and with this value set, an animation with 2 iterations would end halfway through a third iteration. Defaults to 0.0.
- The number of times the animation should repeat. Defaults to
1, and can also take a value of
Infinityto make it repeat for as long as the element exists.
The following options are currently not shipped anywhere, but will be added in the near future:
- Determines how values are combined between this animation and the element's underlying values.
- Determines how values build from iteration to iteration in the current animation.
- Determines how keyframes without temporal offsets should be distributed during the animation's duration.
The second type of constructor (see above) creates a clone of an existing
KeyframeEffectReadOnly object instance. Its parameter is as follows:
KeyframeEffectReadOnlyobject that you want to clone.
The definition of 'KeyframeEffectReadOnly.keyframeEffectReadOnly()' in that specification.
|Working Draft||Editor's draft.|
|Feature||Chrome||Edge||Firefox (Gecko)||Internet Explorer||Opera||Safari (WebKit)|
|Basic support||(Yes)||No support||(Yes)||No support||No support||No support|
||No support||No support||No support||No support||No support||No support|
|Clone constructor (2nd type)||(Yes)||No support||No support||No support||No support||No support|
|Feature||Android||Android Webview||Chrome for Android||Firefox Mobile (Gecko)||IE Mobile||Opera Mobile||Safari Mobile|
|Basic support||(Yes)||(Yes)||(Yes)||(Yes)||No support||No support||No support|
||No support||No support||No support||No support||No support||No support||No support|
|Clone constructor (2nd type)||(Yes)||(Yes)||(Yes)||No support||No support||No support||No support|
 Only enabled in Firefox 52 Nightly and Dev edition. Turned off in Beta/release.