KeyframeEffect: setKeyframes() Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2020.

Die setKeyframes()-Methode der KeyframeEffect-Schnittstelle ersetzt die Keyframes, die den betroffenen KeyframeEffect ausmachen, durch einen neuen Satz von Keyframes.

Syntax

js
setKeyframes(keyframes)

Parameter

keyframes

Ein Keyframe-Objekt oder null. Wenn auf null gesetzt, werden die Keyframes durch eine Sequenz leerer Keyframes ersetzt.

Weitere Informationen über das Format eines Keyframe-Objekts.

Rückgabewert

Keine (undefined).

Ausnahmen

Ausnahme Erklärung
TypeError Eines oder mehrere der Frames waren nicht vom richtigen Objekttyp, die Keyframes waren nicht ungefähr nach Offset sortiert, oder ein Keyframe existierte mit einem Offset von weniger als 0 oder mehr als 1.

Hinweis: Wenn die Keyframes nicht verarbeitet werden können oder fehlerhaft sind, werden die Keyframes des KeyframeEffect nicht geändert.

Beispiele

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

Spezifikationen

Specification
Web Animations
# dom-keyframeeffect-setkeyframes

Browser-Kompatibilität

Siehe auch