Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

animation-composition: sostituire, aggiungere o accumulare un effetto

Scegli come combinare un valore animato con quello sottostante.

Versione: CSS Modules

Sintassi

animation-composition: replace | add | accumulate;

animation-composition stabilisce come combinare un effetto di animazione con il valore sottostante. Questo può provenire dagli stili ordinari o da effetti precedenti nella pila: basta quindi una sola animazione per mostrare la differenza. Il valore iniziale replace usa il valore dell’effetto; add e accumulate seguono le regole di addizione e accumulazione della proprietà animata. Queste operazioni non corrispondono sempre alla normale somma di numeri.

Per gli elenchi di trasformazioni, l’addizione accoda l’elenco dell’effetto a quello sottostante. L’ordine conta: una scala già presente può moltiplicare una traslazione aggiunta. L’accumulazione combina invece le operazioni corrispondenti con le regole appropriate di corrispondenza o di matrice; i fattori di scala si combinano rispetto al valore neutro uno. La proprietà non richiede accumulazione tra iterazioni successive. Un elenco separato da virgole corrisponde ai nomi delle animazioni; una composizione dichiarata in un fotogramma chiave può sostituire la scelta generale dell’effetto per le sue proprietà.

L’esempio parte da una traslazione orizzontale di 10px seguita da scala 2 e anima un valore costante con traslazione 20px seguita da scala 3. A 500ms, la sostituzione dà scala/traslazione 3/20; l’addizione 6/50; l’accumulazione 4/30. L’ultima scala è 2+3-1, mentre la traslazione additiva è 10+2×20. Questi componenti di matrice misurati spiegano perché sommare indiscriminatamente tutti i numeri sarebbe sbagliato.

Esempi

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('; '));

Risultato

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

Ogni modalità usa un elemento creato indipendentemente, con fotogrammi chiave identici e un tempo di campionamento esplicito. Il risultato riguarda questi elenchi di trasformazioni compatibili, non ogni proprietà o ogni possibile scomposizione di matrici.

Fonti