WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

animation-composition: einen Effekt ersetzen, addieren oder akkumulieren

Bestimme, wie ein animierter Wert mit dem darunterliegenden Wert kombiniert wird.

Version: CSS Modules

Syntax

animation-composition: replace | add | accumulate;

animation-composition legt fest, wie ein Animationseffekt mit seinem zugrunde liegenden Wert kombiniert wird. Dieser kann aus gewöhnlichen Stilen oder früheren Effekten im Stapel stammen; deshalb zeigt schon eine einzelne Animation den Unterschied. Der Anfangswert replace verwendet den Effektwert. add und accumulate folgen den Additions- beziehungsweise Akkumulationsregeln der animierten Eigenschaft. Diese Vorgänge sind nicht grundsätzlich gewöhnliche Zahlenaddition.

Bei Transformationslisten hängt die Addition die Effektliste hinter die zugrunde liegende Liste. Die Reihenfolge zählt: Eine vorhandene Skalierung kann eine hinzugefügte Verschiebung skalieren. Akkumulation kombiniert dagegen entsprechende Operationen nach den passenden Zuordnungs- oder Matrixregeln; Skalierungsfaktoren werden relativ zum neutralen Wert eins kombiniert. Die Eigenschaft fordert keine Akkumulation zwischen aufeinanderfolgenden Iterationen an. Eine kommagetrennte Liste wird Animationsnamen zugeordnet. Eine Komposition innerhalb eines Keyframes kann die Einstellung auf Effektebene für dessen Eigenschaften überschreiben.

Im Beispiel besteht der zugrunde liegende Wert aus einer horizontalen Verschiebung um 10px mit anschließender Skalierung um Faktor 2. Der konstante animierte Wert verschiebt um 20px und skaliert um Faktor 3. Bei 500ms liefert Ersetzen Skalierung/Verschiebung 3/20, Addition 6/50 und Akkumulation 4/30. Der letzte Skalierungsfaktor ist 2+3-1; die additive Verschiebung ist 10+2×20. Diese gemessenen Matrixkomponenten zeigen, warum man nicht einfach alle Zahlen addieren darf.

Beispiele

const style=document.createElement('style');style.textContent='@keyframes layer{from,to{transform:translateX(20px) scale(3)}}';document.head.append(style);
const values=[];
for(const composition of ['replace','add','accumulate']){const box=document.createElement('div');box.style.cssText='transform:translateX(10px) scale(2);animation:layer 1s linear both paused';box.style.animationComposition=composition;document.body.append(box);box.getAnimations()[0].currentTime=500;const matrix=new DOMMatrix(getComputedStyle(box).transform);values.push(composition+'='+matrix.a+','+matrix.e)}
console.log(values.join('; '));

Ergebnis

replace=3,20; add=6,50; accumulate=4,30

Jeder Modus nutzt ein separat erzeugtes Element mit identischen Keyframes und expliziter Messzeit. Das Ergebnis gilt für diese kompatiblen Transformationslisten, nicht für jede Eigenschaft oder sämtliche Matrixzerlegungen.

Quellen