KeyframeEffect:setKeyframes() 方法

Baseline 已广泛支持

此特性已经十分成熟,可在许多设备和浏览器版本上使用。自 2020 年 7 月以来,它已在各大浏览器中可用。

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

语法

js
setKeyframes(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

浏览器兼容性

另见