CKTIS / CSS
animation-name: połączenie elementu z klatkami
Wybierz nazwane reguły @keyframes i skoordynuj kilka animacji tego samego elementu.
Wersja: CSS Modules
Składnia
animation-name: Fade, lift;animation-name wybiera regułę @keyframes dla każdej animacji. Nazwy rozróżniają wielkość liter: Fade i fade są różne. Brak pasującej reguły nie tworzy animacji nawet przy ustawionych innych właściwościach czasu. Początkowe słowo none również oznacza brak animacji; istniejąca nazwa nadal potrzebuje odpowiednich ustawień czasu, ponieważ cykl o zerowej długości nie pokazuje zwykłej stopniowej zmiany. Nazwa klatek może być dozwolonym własnym identyfikatorem lub tekstem w cudzysłowie; none bez cudzysłowu pozostaje słowem wyłączającym.
Kilka animacji rozdziel przecinkami. Lista nazw określa ich liczbę, a krótsze listy czasów i innych ustawień są powtarzane, aby do niej pasowały; animacje działają razem, a nie automatycznie jedna po drugiej. Przy domyślnym składaniu replace, gdy dwa efekty animują tę samą właściwość, pierwszeństwo podczas swojego działania ma późniejszy na liście nazw. Nazwanie animacji nie powoduje jej dziedziczenia przez dzieci. Usunięcie nazwy usuwa efekt, również wypełnienie.
Przykład definiuje Fade, lift i dim. Błędne fade daje zero obiektów animacji; Fade w chwili 500ms daje przezroczystość 0.5. Fade, lift tworzy dwie animacje korzystające z jednego ustawienia czasu 1s, a lift przesuwa element o 50px. Fade, dim też tworzy dwa obiekty, ale w odczytywanej chwili dim nadaje przezroczystość 0.3. Zmiana animation-name na none pozostawia zero animacji i przywraca zwykłą przezroczystość 0.3.
Przykłady
const style=document.createElement('style');style.textContent='@keyframes Fade{from{opacity:0}to{opacity:1}} @keyframes lift{from{transform:translateX(0)}to{transform:translateX(100px)}} @keyframes dim{from{opacity:0.2}to{opacity:0.4}}';document.head.append(style);
const el=document.createElement('div');el.style.cssText='opacity:0.3;animation-duration:1s;animation-timing-function:linear;animation-fill-mode:both;animation-play-state:paused';document.body.append(el);
const apply=names=>{el.style.animationName=names;const animations=el.getAnimations();for(const animation of animations)animation.currentTime=500;return animations};
const missing=apply('fade').length,matched=apply('Fade');const opacity=getComputedStyle(el).opacity;
const pair=apply('Fade, lift');const movement=new DOMMatrixReadOnly(getComputedStyle(el).transform).m41;
const conflict=apply('Fade, dim');const winner=getComputedStyle(el).opacity;
const none=apply('none').length;
console.log('missing='+missing+'; matched='+matched.length+'; opacity='+opacity);
console.log('names='+pair.map(animation=>animation.animationName).join(',')+'; duration='+pair.map(animation=>animation.effect.getComputedTiming().duration).join(',')+'; movement='+movement);
console.log('conflict='+winner+'; count='+conflict.length+'; none='+none+'; restored='+getComputedStyle(el).opacity);Wynik
missing=0; matched=1; opacity=0.5 names=Fade,lift; duration=1000,1000; movement=50 conflict=0.3; count=2; none=0; restored=0.3
Wykonano w Chromium 157.0.8103.51. Rzeczywiste obiekty CSSAnimation i obliczone style potwierdzają dopasowanie nazw, powtarzanie ustawień list oraz domyślne zastępowanie. Przykład nie bada składania addytywnego, nazw w cudzysłowie ani zakresu nazw w drzewach cienia.