Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / CSS

animation-composition: reemplazar, añadir o acumular un efecto

Elige cómo se combina un valor animado con el valor que tiene por debajo.

Versión: CSS Modules

Sintaxis

animation-composition: replace | add | accumulate;

animation-composition determina cómo se combina el efecto de una animación con su valor subyacente. Ese valor puede proceder de los estilos normales o de efectos anteriores en la pila; incluso una sola animación permite observar la diferencia. El valor inicial replace usa el valor del efecto; add y accumulate aplican las reglas de adición y acumulación de la propiedad animada. No siempre se trata de sumas numéricas corrientes.

En las listas de transformaciones, la adición coloca la lista del efecto después de la lista subyacente. El orden importa: una escala previa puede multiplicar una traslación añadida. La acumulación combina, en cambio, operaciones correspondientes con las reglas adecuadas de correspondencia o matrices; los factores de escala se combinan respecto de su valor neutro, uno. Esta propiedad no solicita acumulación entre iteraciones sucesivas. Una lista separada por comas corresponde a los nombres de animación, y una composición declarada dentro de un fotograma clave puede sustituir la elección global del efecto para sus propiedades.

El ejemplo tiene una traslación horizontal subyacente de 10px seguida de escala 2, y un valor animado constante de traslación 20px seguido de escala 3. A los 500ms, el reemplazo produce escala/traslación 3/20; la adición, 6/50; y la acumulación, 4/30. La última escala es 2+3-1, mientras que la traslación aditiva es 10+2×20. Estas componentes de matriz medidas muestran por qué sería incorrecto sumar sin más todos los números.

Ejemplos

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

Resultado

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

Cada modo utiliza un elemento creado de forma independiente, con fotogramas clave idénticos y un tiempo de muestreo explícito. El resultado cubre estas listas de transformaciones compatibles, no todas las propiedades ni todas las descomposiciones de matrices.

Fuentes