CKTIS / CSS
animation-composition: zastąpienie, dodanie lub akumulacja efektu
Wybierz sposób łączenia wartości animowanej z wartością znajdującą się pod nią.
Wersja: CSS Modules
Składnia
animation-composition: replace | add | accumulate;animation-composition wybiera sposób łączenia efektu animacji z wartością bazową. Może ona pochodzić ze zwykłych stylów albo wcześniejszych efektów w stosie, więc różnicę pokazuje nawet jedna animacja. Początkowe replace używa wartości efektu; add i accumulate stosują reguły dodawania i akumulacji animowanej właściwości. Nie zawsze oznacza to zwykłe dodawanie liczb.
Dla list transformacji dodawanie dopisuje listę efektu za listą bazową. Kolejność ma znaczenie: bazowe skalowanie może przeskalować dodane przesunięcie. Akumulacja łączy natomiast odpowiadające operacje, stosując odpowiednie reguły dopasowania lub macierzy; współczynniki skali łączy względem neutralnej wartości jeden. Ta właściwość nie zleca akumulacji między kolejnymi iteracjami. Lista rozdzielona przecinkami odpowiada nazwom animacji, a składanie zadeklarowane w klatce kluczowej może zastąpić wybór całego efektu dla jej właściwości.
Przykład ma bazowe przesunięcie poziome 10px, po którym zapisano skalę 2, oraz stałe animowane przesunięcie 20px ze skalą 3. Przy 500ms zastąpienie daje skalę/przesunięcie 3/20, dodawanie 6/50, a akumulacja 4/30. Ostatnia skala to 2+3-1, natomiast przesunięcie przy dodawaniu wynosi 10+2×20. Te zmierzone składniki macierzy pokazują, dlaczego bezmyślne dodanie wszystkich liczb byłoby błędem.
Przykłady
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('; '));Wynik
replace=3,20; add=6,50; accumulate=4,30
Każdy tryb używa osobno utworzonego elementu z identycznymi klatkami i jawnym czasem próbki. Wynik dotyczy tych zgodnych list transformacji, nie każdej właściwości ani wszystkich rozkładów macierzy.