KeyframeEffect: setKeyframes() method
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{ APIRef("Web Animations") }}
The **setKeyframes()** method of the {{domxref("KeyframeEffect")}} interface replaces the keyframes that make up the affected KeyframeEffect with a new set of keyframes.
Syntax
setKeyframes(keyframes)Parameters
keyframes- : A keyframe object or
null. If set tonull, the keyframes are replaced with a sequence of empty keyframes.
More information about a keyframe object's format.
Return value
None ({{jsxref("undefined")}}).
Exceptions
<table class="no-markdown"> <thead> <tr> <th scope="col">Exception</th> <th scope="col">Explanation</th> </tr> </thead> <tbody> <tr> <td><code>TypeError</code></td> <td> One or more of the frames were not of the correct type of object, the keyframes were not <a href="https://w3c.github.io/web-animations/#loosely-sorted-by-offset"
توجه: loosely sorted by offset</a , or a keyframe existed with an offset of less than 0 or more than 1.
</td> </tr> </tbody> </table>
توجه: If the keyframes cannot be processed or are malformed, the KeyframeEffect's keyframes are not modified.
Examples
// passing an array of keyframe objects
existingKeyframeEffect.setKeyframes([
{ color: "blue" },
{ color: "green", left: "10px" },
]);
// passing an object with arrays for values
existingKeyframeEffect.setKeyframes({
color: ["blue", "green"],
left: ["0", "10px"],
});
// passing a single-member object
existingKeyframeEffect.setKeyframes({
color: "blue",
});Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- KeyframeEffect Interface
- Web Animations API