CKTIS / CSS
animation-name: conectar un elemento con fotogramas clave
Selecciona reglas @keyframes con nombre y coordina varias animaciones sobre el mismo elemento.
Versión: CSS Modules
Sintaxis
animation-name: Fade, lift;animation-name selecciona la regla @keyframes de cada animación. Los nombres distinguen mayúsculas y minúsculas: Fade y fade son diferentes. Si no existe una regla coincidente, no se crea ninguna animación, aunque estén presentes otras propiedades temporales. La palabra clave inicial none también significa que no hay animación; un nombre existente sigue necesitando temporización adecuada, pues un ciclo de duración cero no muestra un cambio gradual normal. Un nombre de fotogramas puede ser un identificador personalizado permitido o una cadena entre comillas; none sin comillas sigue siendo la palabra de desactivación.
Usa comas para varias animaciones. La lista de nombres determina su número, y las listas más cortas de duración u otros ajustes se repiten para corresponder con ella; las animaciones funcionan juntas en vez de ponerse automáticamente en cola. Con la composición replace predeterminada, cuando dos efectos animan la misma propiedad, el situado después en la lista de nombres tiene prioridad mientras se aplica. Dar nombre a una animación no hace que los elementos hijos la hereden. Eliminar su nombre elimina su efecto, incluido cualquier relleno.
El ejemplo define Fade, lift y dim. El nombre incorrecto fade produce cero objetos de animación; Fade en 500ms da opacidad 0.5. Fade, lift crea dos animaciones que comparten el único ajuste de duración 1s, y lift mueve el elemento 50px. Fade, dim también crea dos objetos, pero dim aporta opacidad 0.3 en el instante consultado. Cambiar animation-name a none deja cero animaciones y restaura la opacidad subyacente 0.3.
Ejemplos
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);Resultado
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
Ejecutado en Chromium 157.0.8103.51. Objetos CSSAnimation y estilos calculados reales confirman la coincidencia de nombres, la repetición de ajustes de lista y el reemplazo predeterminado. El ejemplo no prueba composición aditiva, nombres entre comillas ni el ámbito de nombres en árboles de sombra.