Vocabulario de Animación
Este repositorio (Asymmetric-al/core)
Este superposición de propiedad del repo mantiene el glosario upstream acotado y compatible con la guía canónica de frontend de Core. Reconcilíalo tras las actualizaciones upstream antes de ejecutar bun run skills:sync.
Disparadores
- Un usuario describe un efecto de movimiento pero no sabe su nombre.
- Una discusión de diseño o implementación necesita vocabulario preciso de animación.
- No uses este skill como estándar de implementación o revisión.
- Una solicitud concreta para nombrar un efecto de movimiento debe responderse directamente. La Respuesta Inicial upstream aplica solo a una invocación sin pregunta ni tarea.
Flujo de trabajo
- Usa el glosario upstream para nombrar y desambiguar el efecto.
- Mantén la respuesta concisa y no conviertas una solicitud de nombre en trabajo de UI.
- Si luego continúa la implementación o revisión, carga
docs/ai/rules/frontend.mdydocs/ai/skills/anim/SKILL.md; esos contratos del repo tienen prioridad.
Lista de verificación
- La respuesta encabeza con el término de glosario más preciso.
- Las alternativas cercanas se distinguen sin inventar vocabulario.
- Cualquier consejo de implementación se difiere a las reglas de frontend y motion de Core.
Respuesta Inicial
Cuando este skill se invoca por primera vez sin una pregunta específica, responde solo con:
Estoy listo para ponerle nombre a cualquier efecto de movimiento que describas, mi conocimiento proviene de la filosofía de animación de Emil Kowalski.
Convierte una descripción vaga de un movimiento o efecto en el término preciso, para que el usuario sepa qué pedir.
Inicio Rápido
El usuario describe un efecto de manera imprecisa. Tú devuelves el/los término(s) coincidente(s) en este formato:
**Stagger** — Anima varios elementos uno tras otro con un pequeño retraso entre cada uno, creando una cascada.
Si varios términos pueden encajar, lista la mejor coincidencia primero, luego 1–2 alternativas con una nota de una línea sobre en qué se diferencian.
Instrucciones
- Lee por intención, no por palabras clave. Los usuarios describen lo que ven o sienten («elástico», «se desliza», «se dibuja solo»), no el nombre técnico. Mapea la sensación al glosario a continuación.
- Cita el glosario textualmente. Sus descripciones son autoritativas — úsalas tal cual, no las parafrasees.
- Desambigua términos cercanos. Cuando dos compiten (Clip-path vs Máscara, Pop in vs Rebote, Transición de elemento compartido vs Animación de layout), contrasta para que el usuario pueda elegir.
- Cuando nada coincida exactamente, nombra el término más cercano y di claramente que es una aproximación, o describe el efecto usando el vocabulario del glosario (p. ej., «eso es un stagger de entradas scale-in»).
- Mantente dentro de este glosario. Si un término realmente no está aquí, dilo en lugar de inventar uno — aunque puedes explicar el concepto usando estas palabras.
- Sé conciso. Una pregunta de nombre quiere un nombre, no un ensayo. Empieza con el término; amplía solo si te lo piden.
Ejemplos
Ejemplo 1 — basado en sensación Usuario: «¿Cómo se llama cuando un popover parece crecer desde el botón en el que hiciste clic en lugar de desde su centro?» Salida:
**Animación con origen consciente** — Un elemento se anima desde su disparador, como un popover que crece desde el botón que lo abrió en lugar de desde su propio centro que es el valor por defecto en CSS.
Ejemplo 2 — desambiguación Usuario: «La cosa donde una imagen se convierte en otra imagen.» Salida:
**Morph** — Una forma se transforma suavemente en otra forma, p. ej. Dynamic Island.
Alternativas cercanas:
- **Crossfade** — si simplemente se funden una sobre otra en el mismo lugar.
- **Transición de elemento compartido** — si un elemento viaja y se transforma de una posición a otra.
Ejemplo 3 — sensación física Usuario: «Ese scroll de iOS que resiste y rebota cuando tiras demasiado lejos.» Salida:
**Rubber-banding** — Resistencia y rebote cuando arrastras más allá de un límite (la sensación de overscroll de iOS).
Glosario
Una instantánea curada que refleja la página /vocabulary del proyecto; mantén ambos sincronizados cuando cualquiera cambie.
Entradas y Salidas — cómo aparecen y desaparecen los elementos
- Fade in / Fade out — El elemento aparece o desaparece cambiando la opacidad.
- Slide in — El elemento entra deslizándose desde fuera de la pantalla (izquierda, derecha, arriba o abajo).
- Scale in — El elemento crece de más pequeño a tamaño completo al aparecer, a menudo acompañado de un fundido.
- Pop in — El elemento aparece con un ligero rebasamiento, como si rebotara en su lugar.
- Reveal — El contenido se descubre gradualmente, a menudo animando un clip-path o máscara.
- Enter / Exit — La animación que reproduce un elemento cuando se añade o elimina de la pantalla.
Secuenciación y Temporización — coordinando múltiples elementos o momentos
- Keyframes — Puntos definidos en una animación (0%, 50%, 100%) que el navegador rellena entre ellos.
- Interpolation / Tween — Generar todos los fotogramas intermedios entre un valor inicial y final, para que el movimiento sea continuo.
- Stagger — Anima varios elementos uno tras otro con un pequeño retraso entre cada uno, creando una cascada.
- Orchestration — Temporizar deliberadamente múltiples animaciones para que se sientan como un movimiento coordinado.
- Delay — Tiempo antes de que comience una animación.
- Duration — Cuánto dura una animación.
- Fill mode — Si un elemento mantiene los estilos de su primer o último fotograma antes de que la animación comience o después de que termine (p. ej. forwards).
- Stepped animation — Una animación dividida en pasos discretos, como un temporizador de cuenta atrás.
Movimiento y Transformaciones — cambiando la posición, tamaño o ángulo de un elemento
- Translate — Mover un elemento a lo largo del eje X o Y.
- Scale — Hacer un elemento más grande o más pequeño.
- Rotate — Girar un elemento alrededor de un punto.
- Skew — Inclinar un elemento a lo largo del eje X o Y, deformándolo fuera de su forma rectangular.
- 3D tilt / Flip — Rotar en el espacio 3D (rotateX / rotateY) para añadir profundidad.
- Perspective — Qué tan fuerte se ve el efecto 3D — un valor más bajo exagera la profundidad, como si el espectador estuviera más cerca.
- Transform origin — El punto de anclaje desde el que crece o gira una escala o rotación.
- Animación con origen consciente — Un elemento se anima desde su disparador, como un popover que crece desde el botón que lo abrió en lugar de desde su propio centro que es el valor por defecto en CSS.
Transiciones Entre Estados — conectando un estado, vista o elemento a otro
- Crossfade — Un elemento se desvanece mientras otro aparece en el mismo lugar.
- Continuity transition — Un cambio que mantiene al usuario orientado conectando visualmente el antes y el después. Por ejemplo, haciendo el mismo rectángulo más grande y más pequeño.
- Morph — Una forma se transforma suavemente en otra forma, p. ej. Dynamic Island.
- Transición de elemento compartido — Un elemento viaja y se transforma de una posición a otra, como una miniatura expandiéndose en una tarjeta.
- Layout animation — Cuando el tamaño o posición de un elemento cambia, se anima al nuevo lugar en lugar de saltar.
- Accordion / Collapse — Una sección expande y colapsa su altura suavemente para mostrar u ocultar contenido.
- Direction-aware transition — El contenido se desliza en una dirección al avanzar y en la opuesta al retroceder, dando a la navegación un sentido de dirección.
Scroll — movimiento ligado al desplazamiento o a la navegación entre vistas
- Scroll reveal — Los elementos aparecen o se deslizan a medida que entran en el viewport.
- Scroll-driven animation — Una animación cuyo progreso está ligado directamente a la posición de scroll.
- Parallax — El fondo y el primer plano se mueven a diferentes velocidades al hacer scroll, creando profundidad.
- Page transition — Una animación que se reproduce al navegar de una página o ruta a otra.
- View transition — El navegador transforma entre dos estados o páginas, conectando elementos compartidos.
Feedback e Interacción — respondiendo a las acciones del usuario
- Hover effect — Cambio visual cuando el cursor pasa sobre un elemento.
- Press / Tap feedback — Una sutil reducción de escala cuando se hace clic en un elemento, para que se sienta físico.
- Hold to confirm — Un efecto de progreso que se llena mientras el usuario mantiene presionado un botón.
- Drag — Mover un elemento agarrándolo, a menudo con inercia al soltarlo.
- Drag to reorder — Arrastrar elementos en una lista para reordenarlos, mientras los demás se desplazan para hacer espacio.
- Swipe to dismiss — Arrastrar un elemento fuera de la pantalla para cerrarlo, como un cajón o un toast.
- Rubber-banding — Resistencia y rebote cuando arrastras más allá de un límite (la sensación de overscroll de iOS).
- Shake / Wiggle — Una vibración rápida de lado a lado que señala un error o entrada rechazada.
- Ripple — Un círculo que se expande desde el punto de un toque, confirmando la pulsación.
Easing — cómo cambia la velocidad durante una animación
- Easing — La velocidad a la que una animación acelera o desacelera.
- Ease-out — Comienza rápido, termina lento. El valor por defecto para la mayoría de UI y cualquier cosa que responda al usuario.
- Ease-in — Comienza lento, termina rápido. Generalmente se evita; puede sentirse lento.
- Ease-in-out — Lento, rápido, lento. Bueno para elementos ya en pantalla que se mueven de A a B.
- Linear — Velocidad constante. Evítalo para UI; resérvalo para spinners o marquees.
- Cubic-bezier — Una curva de easing personalizada que defines para un control preciso.
- Asymmetric easing — Una curva que acelera y desacelera a diferentes ritmos. Se siente más viva que una simétrica.
Animaciones con Resorte — movimiento basado en física como alternativa al easing de duración fija
- Spring — Movimiento impulsado por física (tensión, masa, amortiguación) en lugar de una duración fija.
- Stiffness / Tension — Con qué fuerza el resorte tira hacia su objetivo. Mayor valor se siente más rápido.
- Damping — Qué tan rápido se estabiliza un resorte. Menor amortiguación significa más rebote y oscilación.
- Mass — Qué tan pesado se siente el elemento animado. Más masa lo hace más lento y pesado.
- Bounce — Un resorte que sobrepasa y se estabiliza, añadiendo alegría.
- Perceptual duration — Cuánto tiempo se siente terminado un resorte, aunque siga micro-estabilizándose por debajo.
- Momentum — Movimiento que lleva velocidad, especialmente después de un arrastre o interrupción.
- Velocity — Qué tan rápido y en qué dirección se mueve un elemento. Un resorte lo lleva a la siguiente animación si se interrumpe, para que un elemento lanzado mantenga su velocidad.
- Interruptible animation — Una animación que puede redirigirse suavemente a medio vuelo en lugar de terminar primero.
Bucle y Movimiento Ambiental — animaciones que se ejecutan solas
- Marquee — Texto o contenido que se desplaza continuamente en un bucle.
- Loop — Una animación que se repite, un número determinado de veces o infinitamente.
- Alternate (yoyo) — Un bucle que se reproduce hacia adelante y luego invierte cada iteración, en lugar de saltar de vuelta al inicio.
- Orbit — Un elemento que gira alrededor de otro en un camino continuo.
- Pulse — Un cambio suave y repetitivo de escala u opacidad para llamar la atención.
- Float — Una deriva suave y continua hacia arriba y hacia abajo que hace que un elemento estático se sienta vivo y sin peso.
- Idle animation — Movimiento sutil que se reproduce mientras un elemento está simplemente ahí, esperando ser interactuado.
Pulido y Efectos — los pequeños detalles que separan lo bueno de lo excelente
- Blur — Un filtro de desenfoque usado para suavizar un elemento o enmascarar pequeñas imperfecciones.
- Clip-path — Recortar un elemento a una forma, usado para revelados, máscaras y controles deslizantes de antes/después.
- Mask — Ocultar o revelar partes de un elemento usando una forma o gradiente — como clip-path, pero con bordes suaves y difuminables.
- Before / after slider — Un divisor arrastrable que barre entre dos imágenes superpuestas para compararlas.
- Line drawing — Una ruta SVG que se dibuja sola, como un lápiz invisible trazándola.
- Text morph — Texto que se anima carácter por carácter cuando cambia, atrayendo la atención al nuevo valor.
- Skeleton / Shimmer — Un marcador de posición con un brillo móvil que se muestra mientras el contenido carga.
- Number ticker — Dígitos que ruedan o cuentan hasta un valor.
- Tabular numbers — Dígitos de ancho fijo para que los números no se desplacen al cambiar. Esencial para tickers, temporizadores y contadores.
- Typewriter — Texto que aparece un carácter a la vez, como si se estuviera escribiendo.
Rendimiento — lo que mantiene el movimiento fluido en lugar de entrecortado
- Frame rate (FPS) — Fotogramas dibujados por segundo. 60fps es la línea base para movimiento suave; 120fps en pantallas más nuevas.
- Jank — Parpadeo visible cuando el navegador pierde fotogramas porque no puede seguir el ritmo de la animación.
- Dropped frame — Un fotograma que el navegador no pudo dibujar a tiempo, causando un pequeño tirón en el movimiento.
- Compositing — Dejar que la GPU mueva o desvanezca un elemento en su propia capa sin rehacer el layout o pintado.
- will-change — Una pista CSS de que un elemento está a punto de animarse, para que el navegador pueda promocionarlo a su propia capa con antelación.
- Layout thrashing — Animar propiedades como width, height, top o left que obligan al navegador a recalcular el layout cada fotograma, causando parpadeo.
Principios a Conocer — conceptos que guían cuándo y cómo animar
- Purposeful animation — El movimiento debe servir a una función — orientar, dar feedback, mostrar relaciones — no solo decorar.
- Anticipation — Un pequeño movimiento de preparación en dirección opuesta antes de un movimiento, insinuando lo que está a punto de suceder.
- Follow-through — Partes de un elemento siguen moviéndose y se estabilizan ligeramente después de que el movimiento principal se detiene, añadiendo peso.
- Squash & stretch — Deformar un elemento mientras se mueve para transmitir peso, velocidad y flexibilidad.
- Perceived performance — La animación adecuada hace que una interfaz se sienta más rápida, incluso cuando no lo es.
- Frequency of use — Cuanto más a menudo un usuario ve una animación, más corta y sutil debería ser.
- Spatial consistency — Animar para que un elemento mantenga su identidad y posición entre estados, para que los usuarios nunca pierdan el rastro de dónde fueron las cosas.
- Hardware acceleration — Animar transform y opacity permite que la GPU mantenga el movimiento suave.
- Reduced motion — Respetar la configuración prefers-reduced-motion del usuario reduciendo o eliminando el movimiento.