这是 实验性技术
检查 浏览器兼容性表格 要小心谨慎在生产中使用这之前。

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

句法

var keyframes = new KeyframeEffect(element, keyframeSet, keyframeOptions);
var keyframes = new KeyframeEffect(sourceKeyFrames);
					

参数

The first type of constructor (see above) creates a completely new KeyframeEffect object instance. Its parameters are:

element
The DOM element to be animated, or null .
keyframeSet
An keyframe object or null .
keyframeOptions 可选

Either an integer representing the animation's duration (in milliseconds), or an 对象 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 the pre-defined values "linear" , "ease" , "ease-in" , "ease-out" ,和 "ease-in-out" , or a custom "cubic-bezier" value like "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" ),或 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 the element's underlying values.

iterationComposite

Determines how values build from iteration to iteration in the current animation.

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

sourceKeyFrames
KeyframeEffect object that you want to clone.

范例

Follow the White Rabbit example KeyframeEffect constructor is used to create a set of keyframes that dictate how the White Rabbit should animate down the hole:

 var rabbitDownKeyframes = new KeyframeEffect(
    whiteRabbit, // element to animate
    [
      { transform: 'translateY(0%)' }, // keyframe
      { transform: 'translateY(100%)' } // keyframe
    ],
    { duration: 3000, fill: 'forwards' } // keyframe options
  );
						

规范

规范 状态 注释
Web Animations Level 2
The definition of 'KeyframeEffectOptions.iterationComposite' in that specification.
草案 添加 iterationComposite 选项。
Web 动画
The definition of 'keyframeEffect()' in that specification.
工作草案 编者草案。

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据
桌面 移动
Chrome Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet
KeyframeEffect() 构造函数 Chrome Yes Edge ≤79 Firefox 63 IE No Opera No Safari No WebView Android Yes Chrome Android Yes Firefox Android 63 Opera Android No Safari iOS No Samsung Internet Android Yes

图例

完整支持

完整支持

不支持

不支持

实验。期望将来行为有所改变。

实验。期望将来行为有所改变。

另请参阅

元数据

  • 最后修改: