关键帧效果：setKeyframes() 方法

基线 广泛可用

此功能已建立良好，可在许多设备和浏览器版本上运行。自以下时间起，它已在浏览器中可用 2020 年 3 月.

setKeyframes() 方法是 KeyframeEffect 接口的一部分，它用一组新的关键帧替换构成受影响 KeyframeEffect 的关键帧。

语法

js
setKeyframes(keyframes)

参数

keyframes

关键帧对象或 null。如果设置为 null，则关键帧将被替换为一系列空关键帧。

有关关键帧对象 格式 的更多信息。

返回值

无 (undefined).

异常

异常 解释
TypeError 一个或多个帧不是正确类型的对象，关键帧未 按偏移量松散排序，或者存在偏移量小于 0 或大于 1 的关键帧。

注意：如果无法处理关键帧或关键帧格式错误，则不会修改 KeyframeEffect 的关键帧。

示例

js
// 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",
});

规范

规范
Web 动画
# dom-keyframeeffect-setkeyframes

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。

另请参阅