大网数据广告活动
Web 标准与前端开发

KeyframeEffect: KeyframeEffect() constructor

· 52CE 我爱测

The **`KeyframeEffect()`** constructor of the Web Animations API returns a new KeyframeEffect object instance, and also allows you to clone an existing keyframe effect object instance.

Web Animations

The KeyframeEffect() constructor of the Web Animations API returns a new KeyframeEffect object instance, and also allows you to clone an existing keyframe effect object instance.

Syntax

new KeyframeEffect(target, keyframes)
new KeyframeEffect(target, keyframes, options)
new KeyframeEffect(sourceKeyFrames)

Parameters

The multi-argument constructor (see above) creates a completely new KeyframeEffect object instance. Its parameters are:

  • target
    • : The DOM element to be animated, or null.
  • keyframes
  • options
    • : Either an integer representing the animation's duration (in milliseconds), or an object containing one or more of the following:
      • delay

        • : The number of milliseconds to delay the start of the animation. Defaults to 0.
      • direction

        • : 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 "normal".
      • duration

        • : 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.
      • easing

        • : The rate of the animation's change over time. Accepts an easing-function, such as "linear", "ease-in", "step-end", or "cubic-bezier(0.42, 0, 0.58, 1)". Defaults to "linear".
      • endDelay

        • : 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.
      • fill

        • : Dictates whether the animation's effects should be reflected by the element(s) prior to playing ("backwards"), retained after the animation has completed playing ("forwards"), or both. Defaults to "none".
      • iterationStart

        • : 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.
      • iterations

        • : The number of times the animation should repeat. Defaults to 1, and can also take a value of Infinity to make it repeat for as long as the element exists.
      • composite

        • : Determines how values are combined between this animation and other, separate animations that do not specify their own specific composite operation. Defaults to replace.
          • add dictates an additive effect, where each successive iteration builds on the last. For instance with transform, a translateX(-200px) would not override an earlier rotate(20deg) value but result in translateX(-200px) rotate(20deg).
          • accumulate is similar but a little smarter: blur(2) and blur(5) become blur(7), not blur(2) blur(5).
          • replace overwrites the previous value with the new one.
      • iterationComposite

        • : Determines how values build from iteration to iteration in this animation. Can be set to accumulate or replace (see above). Defaults to replace.
      • pseudoElement

        • : A string containing a pseudo-elements selector, such as "::before". If present, the effect is applied to the selected pseudo-element of target, rather than to target itself.

The single argument constructor (see above) creates a clone of an existing KeyframeEffect object instance. Its parameter is as follows:

  • sourceKeyFrames
    • : A KeyframeEffect object that you want to clone.

Examples

In the following example, the KeyframeEffect constructor is used to create a set of keyframes that dictate how the emoji should roll on the floor:

const emoji = document.querySelector("div"); // element to animate

const rollingKeyframes = new KeyframeEffect(
  emoji,
  [
    { transform: "translateX(0) rotate(0)" }, // keyframe
    { transform: "translateX(200px) rotate(1.3turn)" }, // keyframe
  ],
  {
    // keyframe options
    duration: 2000,
    direction: "alternate",
    easing: "ease-in-out",
    iterations: "Infinity",
  },
);

const rollingAnimation = new Animation(rollingKeyframes, document.timeline);
rollingAnimation.play();
<div>🤣</div>
body {
  box-shadow: 0 5px 5px pink;
}

div {
  width: fit-content;
  margin-left: calc(50% - 132px);
  font-size: 64px;
  user-select: none;
  margin-top: 1rem;
}

Examples

Specifications

Browser compatibility

See also

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。