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 March 2020.

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

Syntax

js
setKeyframes(keyframes)

Parameter

keyframes

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

Mehr Informationen über das Format eines Keyframe-Objekts.

Rückgabewert

Keiner (undefined).

Ausnahmen

Ausnahme Erläuterung
TypeError Eines oder mehrere der Frames waren nicht vom korrekten Objekttyp, die Keyframes waren nicht lose 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 verä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

BCD tables only load in the browser

Siehe auch