Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

animation-composition : remplacer, ajouter ou accumuler un effet

Choisissez comment une valeur animée se combine avec la valeur située en dessous.

Version : CSS Modules

Syntaxe

animation-composition: replace | add | accumulate;

animation-composition détermine comment un effet d’animation se combine avec sa valeur sous-jacente. Celle-ci peut provenir des styles ordinaires ou d’effets précédents dans la pile : une seule animation suffit donc à montrer la différence. La valeur initiale replace utilise la valeur de l’effet ; add et accumulate suivent les règles d’addition et d’accumulation de la propriété animée. Ces opérations ne sont pas toujours de simples additions numériques.

Pour les listes de transformations, l’addition place la liste de l’effet après la liste sous-jacente. L’ordre compte : une mise à l’échelle déjà présente peut multiplier une translation ajoutée. L’accumulation combine plutôt les opérations correspondantes selon les règles d’appariement ou de matrices appropriées ; les facteurs d’échelle se combinent relativement à leur valeur neutre de un. Cette propriété ne demande pas une accumulation entre itérations successives. Une liste séparée par des virgules correspond aux noms d’animation, et une composition déclarée dans une keyframe peut remplacer le choix global de l’effet pour ses propriétés.

L’exemple part d’une translation horizontale de 10px suivie d’une échelle de 2, et anime une valeur constante composée d’une translation de 20px puis d’une échelle de 3. À 500ms, le remplacement donne échelle/translation 3/20 ; l’addition 6/50 ; l’accumulation 4/30. La dernière échelle vaut 2+3-1, tandis que la translation additive vaut 10+2×20. Ces composantes de matrice mesurées expliquent pourquoi additionner aveuglément tous les nombres serait incorrect.

Exemples

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

Résultat

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

Chaque mode utilise un élément créé indépendamment, avec les mêmes keyframes et un instant de mesure explicite. Le résultat concerne ces listes de transformations compatibles, pas toutes les propriétés ni toutes les décompositions matricielles.

Sources