Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

animation-composition: substituir, adicionar ou acumular um efeito

Escolha como combinar um valor animado com o valor que já existe por baixo.

Versão: CSS Modules

Sintaxe

animation-composition: replace | add | accumulate;

animation-composition define como um efeito de animação se combina com o valor subjacente. Esse valor pode vir dos estilos normais ou de efeitos anteriores na pilha; uma única animação já permite mostrar a diferença. O valor inicial replace usa o valor do efeito; add e accumulate seguem as regras de adição e acumulação da propriedade animada. Estas operações nem sempre são somas numéricas comuns.

Nas listas de transformações, a adição coloca a lista do efeito depois da lista subjacente. A ordem importa: uma escala existente pode multiplicar uma translação adicionada. A acumulação combina operações correspondentes através das regras adequadas de correspondência ou de matrizes; os fatores de escala combinam-se relativamente ao valor neutro um. A propriedade não pede acumulação entre iterações sucessivas. Uma lista separada por vírgulas corresponde aos nomes das animações, e uma composição declarada num fotograma-chave pode substituir a escolha geral do efeito para as suas propriedades.

O exemplo tem uma translação horizontal subjacente de 10px seguida de escala 2, e um valor animado constante com translação 20px seguida de escala 3. Aos 500ms, a substituição dá escala/translação 3/20; a adição 6/50; a acumulação 4/30. A última escala é 2+3-1, enquanto a translação aditiva é 10+2×20. Estes componentes de matriz medidos explicam por que seria errado somar todos os números sem considerar as operações.

Exemplos

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 usa um elemento criado de forma independente, com fotogramas-chave idênticos e um tempo de amostragem explícito. O resultado cobre estas listas de transformações compatíveis, não todas as propriedades nem todas as decomposições de matrizes.

Fontes