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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
setKeyframes

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch