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 getKeyframes() method of a KeyframeEffectReadOnly or a KeyframeEffect returns an Array of the computed keyframes that make up this animation along with their computed offsets.
Syntax
var keyframes = keyframeEffect.getKeyframes();
Parameters
None.
Return value
Returns a sequence of objects with the following format:
- property value pairs
-
As many property value pairs as are contained in each keyframe of the animation.
- offset
-
The offset of the keyframe specified as a number between
0.0and1.0inclusive ornull. This will benullif the keyframe is automatically spaced using.KeyframeEffect.spacing - computedOffset
-
The computed offset for this keyframe, calculated when the list of computed keyframes was produced according to
. UnlikeKeyframeEffect.spacingoffset, above, thecomputedOffsetis nevernull. - easing
-
The timing function used from this keyframe until the next keyframe in the series.
- composite
-
The
KeyframeEffectReadOnly.compositeoperation used to combine the values specified in this keyframe with the underlying value. This will be absent if the composite operation specified on the effect is being used.
Examples
In the Red Queen Race example, we can inspect Alice and the RedQueen's animation to see its individual keyframes like so:
// Return the array of keyframes redQueen_alice.effect.getKeyframes();
Specifications
| Specification | Status | Comment |
|---|---|---|
| Web Animations The definition of 'KeyframeEffectReadOnly.getKeyframes()' in that specification. |
Working Draft | Editor's draft. |
Browser compatibility
| Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|
| Basic support | No support | No support | No support | No support | No support |
| Feature | Android | Android Webview | Chrome for Android | Firefox Mobile (Gecko) | Firefox OS | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|---|---|
| Basic support | ? | ? | No support | No support | ? | ? | ? | ? |
See also
- Web Animations API
- Method of both
KeyframeEffectReadOnlyandKeyframeEffectobjects