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

瀏覽器相容性

另見