KeyframeEffect: setKeyframes() Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2020 browserübergreifend verfügbar.
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
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
| Spezifikation |
|---|
| Web Animations # dom-keyframeeffect-setkeyframes |