Diseño de Animaciones Web
⚠️ Pack Creativo — NO auto-aplicar
Esta habilidad es parte del pack creativo. Úsala cuando la tarea involucre explícitamente animación, movimiento o sensación de interacción. NO la cargues para construcción de UI general — la referencia de movimiento en design-review cubre la calidad de movimiento base.
Úsala cuando: el usuario pregunte sobre animaciones, easing, muelles, transiciones, sensación de interacción, o 'hazlo suave'. Sáltala cuando: construyas UI estándar donde la referencia de movimiento en design-review sea suficiente.
Una guía completa para crear animaciones que se sientan correctas, basada en el curso 'Animations on the Web' de Emil Kowalski.
Respuesta Inicial
Cuando esta habilidad sea invocada por primera vez sin una pregunta específica, responde únicamente con:
Estoy listo para ayudarte con animaciones basadas en el curso animations.dev de Emil Kowalski.
No proporciones ninguna otra información hasta que el usuario haga una pregunta.
Formato de Revisión (Obligatorio)
Al revisar animaciones, DEBES usar una tabla markdown. NO uses una lista con 'Antes:' y 'Después:' en líneas separadas. Siempre genera una tabla markdown real como esta:
| Antes | Después |
|---|---|
transform: scale(0) | transform: scale(0.95) |
animation: fadeIn 400ms ease-in | animation: fadeIn 200ms ease-out |
| Sin soporte de movimiento reducido | @media (prefers-reduced-motion: reduce) {...} |
Formato incorrecto (nunca hagas esto):
Antes: transform: scale(0)
Después: transform: scale(0.95)
────────────────────────────
Antes: duración 400ms
Después: 200ms
Formato correcto: Una única tabla markdown con columnas | Antes | Después |, una fila por problema.
Árbol de Decisión: ¿Qué Herramienta Uso?
¿Esto involucra cambios de layout, transiciones compartidas o animaciones de salida en React?
├── Sí → Framer Motion (animaciones de layout, AnimatePresence, layoutId)
│ Importar desde "motion/react" (NO "framer-motion")
└── No
├── ¿Es una entrada/salida simple o hover? → Transiciones/keyframes CSS
├── ¿Es crítico en rendimiento (página pesada, muchos elementos)? → CSS (acelerado por hardware)
├── ¿Necesita física de muelle o interrumpibilidad? → Framer Motion
├── ¿Necesita seguimiento de gestos (arrastrar, seguir cursor)? → Valores de movimiento FM
└── ¿Es un bucle de velocidad constante? → Keyframes CSS
Siempre revisa prefers-reduced-motion. Sin excepciones.
Inicio Rápido
Cada decisión de animación comienza con estas preguntas:
- ¿Este elemento está entrando o saliendo? → Usa
ease-out - ¿Un elemento en pantalla se está moviendo? → Usa
ease-in-out - ¿Es una transición de hover/color? → Usa
ease - ¿Los usuarios verán esto 100+ veces al día? → No lo animes
El Plano de Easing
ease-out (Más Común)
Úsalo para interacciones iniciadas por el usuario: menús desplegables, modales, tooltips, cualquier elemento que entre o salga de la pantalla.
/* Ordenado de débil a fuerte */
--ease-out-quad: cubic-bezier(0.25, 0.46, 0.45, 0.94);
--ease-out-cubic: cubic-bezier(0.215, 0.61, 0.355, 1);
--ease-out-quart: cubic-bezier(0.165, 0.84, 0.44, 1);
--ease-out-quint: cubic-bezier(0.23, 1, 0.32, 1);
--ease-out-expo: cubic-bezier(0.19, 1, 0.22, 1);
--ease-out-circ: cubic-bezier(0.075, 0.82, 0.165, 1);
Por qué funciona: La aceleración al inicio crea una sensación instantánea y receptiva. El elemento 'salta' hacia su destino y luego se asienta.
ease-in-out (Para Movimiento)
Úsalo cuando elementos ya en pantalla necesitan moverse o transformarse. Imita el movimiento natural como un coche acelerando y luego frenando.
/* Ordenado de débil a fuerte */
--ease-in-out-quad: cubic-bezier(0.455, 0.03, 0.515, 0.955);
--ease-in-out-cubic: cubic-bezier(0.645, 0.045, 0.355, 1);
--ease-in-out-quart: cubic-bezier(0.77, 0, 0.175, 1);
--ease-in-out-quint: cubic-bezier(0.86, 0, 0.07, 1);
--ease-in-out-expo: cubic-bezier(1, 0, 0, 1);
--ease-in-out-circ: cubic-bezier(0.785, 0.135, 0.15, 0.86);
ease (Para Efectos Hover)
Úsalo para estados hover y transiciones de color. La curva asimétrica (inicio más rápido, final más lento) se siente elegante para animaciones suaves.
transition: background-color 150ms ease;
linear (Evitar en UI)
Úsalo solo para:
- Animaciones de velocidad constante (marquesinas, tickers)
- Visualización de tiempo (indicadores de progreso de mantener presionado para eliminar)
Lineal se siente robótico y antinatural para elementos interactivos.
ease-in (Casi Nunca)
Evítalo para animaciones de UI. Hace que las interfaces se sientan lentas porque el inicio lento retrasa la retroalimentación visual.
Regla de Elementos Emparejados
Los elementos que se animan juntos deben usar el mismo easing y duración. Modal + superposición, tooltip + flecha, cajón + fondo—si se mueven como una unidad, deben sentirse como una unidad.
/* Ambos usan la misma temporización */
.modal {
transition: transform 200ms ease-out;
}
.overlay {
transition: opacity 200ms ease-out;
}
Temporización y Duración
Guías de Duración
| Tipo de Elemento | Duración |
|---|---|
| Microinteracciones | 100-150ms |
| UI estándar (tooltips, menús) | 150-250ms |
| Modales, cajones | 200-300ms |
Reglas:
- Las animaciones de UI deben mantenerse por debajo de 300ms
- Los elementos más grandes se animan más lentamente que los más pequeños
- Las animaciones de salida pueden ser ~20% más rápidas que las de entrada
- Coincide la duración con la distancia - mayor recorrido = mayor duración
La Frecuencia
Determina con qué frecuencia los usuarios verán la animación:
- 100+ veces/día → Sin animación (o drásticamente reducida)
- Uso ocasional → Animación estándar
- Raro/primera vez → Puede ser más especial
Ejemplo: Raycast nunca anima porque los usuarios lo abren cientos de veces al día.
Cuándo Animar
Anima:
- Transiciones de entrada/salida para consistencia espacial
- Cambios de estado que se beneficien de continuidad visual
- Respuestas a acciones del usuario (retroalimentación)
- Interacciones poco usadas donde el deleite añade valor
No animes:
- Acciones iniciadas por teclado
- Efectos hover en elementos de uso frecuente
- Cualquier cosa con la que los usuarios interactúen 100+ veces al día
- Cuando la velocidad importa más que la suavidad
Marketing vs. Producto:
- Marketing: Más elaborado, duraciones más largas permitidas
- Producto: Rápido, con propósito, nunca frívolo
Animaciones con Muelle
Los muelles se sienten más naturales porque no tienen duración fija—simulan física real.
Cuándo Usar Muelles
- Interacciones de arrastre con impulso
- Elementos que deben sentirse 'vivos' (Dynamic Island)
- Gestos que pueden interrumpirse a mitad de la animación
- Interfaces orgánicas y divertidas
Configuración
Enfoque de Apple (recomendado):
// Duración + rebote (más fácil de entender)
{ type: "spring", duration: 0.5, bounce: 0.2 }
Física tradicional:
// Masa, rigidez, amortiguamiento (más complejo)
{ type: "spring", mass: 1, stiffness: 100, damping: 10 }
Guías de Rebote
- Evita el rebote en la mayoría de contextos de UI
- Usa rebote para arrastrar para descartar, interacciones divertidas
- Mantén el rebote sutil (0.1-0.3) cuando se use
Interrumpibilidad
Los muelles mantienen la velocidad cuando se interrumpen—las animaciones CSS reinician desde cero. Esto hace que los muelles sean ideales para gestos que los usuarios podrían cambiar a medio movimiento.
Animaciones de Layout (Framer Motion)
La característica más potente de FM. Te permite animar propiedades que CSS no puede: flex-direction, justify-content, cambios de posición.
La Prop layout
Añade layout a cualquier elemento motion.* para animar automáticamente cambios de layout:
<motion.div layout className="element" />
Cuando el tamaño o la posición de este elemento cambia (debido a estado, contenido, hermanos), FM lo anima suavemente. No se necesita medición manual.
Animaciones de Layout Compartidas (layoutId)
Conecta dos elementos separados para que uno se transforme en el otro:
// Resaltador de pestaña—solo se renderiza para la pestaña activa
{activeTab === tab ? (
<motion.div layoutId="tab-indicator" className="highlight" />
) : null}
Casos de uso: resaltadores de pestaña, expansión de tarjeta a modal, transformación de botón a popover, interacción de papelera (imágenes que se mueven entre contenedores).
Truco creativo: layoutId crea ilusiones. El 'placeholder' del popover de retroalimentación es en realidad un <span> con un layoutId compartido—no un placeholder de textarea real. Se transforma de texto de botón a texto de popover.
Animación de Altura Dinámica
FM no puede animar de auto a auto. Usa react-use-measure:
import useMeasure from "react-use-measure";
const [ref, bounds] = useMeasure();
<motion.div animate={{ height: bounds.height }}>
<div ref={ref}>{dynamicContent}</div>
</motion.div>
AnimatePresence (Profundo)
Modos
"sync"(por defecto) — entrada y salida se reproducen simultáneamente"wait"— la salida se completa antes de que comience la entrada (intercambio de icono copiar/marca)"popLayout"— elimina el elemento que sale del flujo de layout inmediatamente (a menudo la elección correcta para UI que se transforma)
Transiciones Conscientes de Dirección
Usa la prop custom para pasar datos dinámicos a componentes que salen (cuyo estado está obsoleto):
<AnimatePresence mode="popLayout" custom={direction}>
<motion.div
key={step}
custom={direction}
initial="enter"
animate="center"
exit="exit"
variants={{
enter: (dir) => ({ x: dir > 0 ? 100 : -100, opacity: 0 }),
center: { x: 0, opacity: 1 },
exit: (dir) => ({ x: dir > 0 ? -100 : 100, opacity: 0 }),
}}
/>
</AnimatePresence>
Reglas Clave
- Siempre añade la prop
keyen elementos animados dentro de AnimatePresence - Usa
initial={false}para saltar la animación de montaje (intercambios de icono, estados de botón) - Error conocido: el cambio rápido puede mostrar ambos elementos—ancla a FM v11.0.10 si te pasa
Valores de Movimiento y Hooks
Los valores de movimiento se actualizan fuera del ciclo de renderizado de React—sin re-renderizados, a 60fps.
useMotionValue — Actualizaciones instantáneas (gestos)
const x = useMotionValue(0);
// Actualiza vía x.set(nuevoValor), lee vía x.get()
<motion.div style={{ x }} />
Úsalo para: seguimiento directo de gestos (distancia de arrastre → escala), cualquier mapeo 1:1 donde el retraso del muelle se sentiría desconectado.
useSpring — Actualizaciones animadas (seguimiento retrasado)
const x = useSpring(0, { mass: 0.1, damping: 16, stiffness: 71 });
// x.set(nuevoValor) lo anima con física de muelle
Úsalo para: seguidores de cursor, efectos de impulso, cualquier cosa que deba seguir detrás de la entrada.
useTransform — Mapea un valor a otro
// Mapeo de rango: posición y [0, 300] → escala [1, 1.5]
const scale = useTransform(y, [0, 300], [1, 1.5]);
// Forma de función: formatea un valor
const display = useTransform(angle, v => `${Math.round(v)}°`);
Úsalo para: efectos vinculados al scroll, efectos de distancia del cursor, formateo de valores.
useMotionTemplate — Interpolación de cadenas con valores de movimiento
const clipPath = useMotionTemplate`inset(0px ${percent}% 0px 0px)`;
<motion.div style={{ clipPath }} />
MotionConfig — Transiciones por defecto para un subárbol
<MotionConfig transition={{ type: "spring", duration: 0.5, bounce: 0.2 }}>
{/* Todos los hijos usan esta transición a menos que se anule */}
</MotionConfig>
Orquestación (Escalonado y Secuenciación)
Las animaciones de entrada escalonadas crean un efecto de ola. Prueba y error hasta que se sienta correcto—no hay fórmula.
Escalonado CSS (sin librería):
.item { animation: fadeSlideIn 400ms ease-out both; }
.item:nth-child(1) { animation-delay: 0ms; }
.item:nth-child(2) { animation-delay: 50ms; }
.item:nth-child(3) { animation-delay: 100ms; }
/* etc. */
Escalonado FM:
const container = {
animate: { transition: { staggerChildren: 0.05 } }
};
const item = {
initial: { opacity: 0, y: 20 },
animate: { opacity: 1, y: 0 }
};
Reglas:
- Mantén los retrasos pequeños (30-80ms entre elementos)
- Limita el tiempo total de la secuencia—10 elementos a 80ms cada uno = 800ms, demasiado lento
- Las páginas de marketing pueden ser más elaboradas; la UI de producto debe ser rápida
Expresión de Marca a Través de la Velocidad de Animación
La temporización de la animación ES identidad de marca:
- Marca rápida (Vercel): instantánea o muy rápida, easing mínimo. 'No perdemos tu tiempo.'
- Marca premium (Stripe): más lenta, más deliberada. Curva
ease(no ease-out) para elegancia. - Marca divertida (Family): muelles con rebote sutil, transformación fluida.
- UI de producto generalmente debe sentirse rápida independientemente de la marca.
- Las páginas de marketing son donde expresas la personalidad de la marca a través del movimiento.
Interfaces Fluídas (Aspiracional)
La estrella del norte: nada 'aparece' o 'desaparece'—todo se transforma. Family (iOS) es el estándar de oro.
- Las animaciones de layout compartidas son la herramienta más cercana en la web a la fluidez nativa
- El movimiento fluido mejora el rendimiento percibido (se siente más rápido incluso con el mismo tiempo de carga)
- Piensa en las animaciones ANTES de diseñar la UI—posiciona los elementos para habilitar transiciones sin interrupciones
- Actualmente difícil en la web, pero es la dirección hacia la que todo se dirige
- La transformación de texto (por ejemplo, cambios de etiqueta de botón) resalta cambios de estado sutilmente
Rendimiento
La Regla de Oro
Solo anima transform y opacity. Estas propiedades omiten las etapas de layout y pintado, ejecutándose completamente en la GPU.
Evita animar:
padding,margin,height,width(activan layout)- Filtros
blurpor encima de 20px (costosos, especialmente Safari) - Variables CSS en árboles de componentes profundos
Técnicas de Optimización
/* Forzar aceleración por GPU */
.animated-element {
will-change: transform;
}
Específico de React:
- Anima fuera del ciclo de renderizado de React cuando sea posible
- Usa refs para actualizar estilos directamente en lugar de estado
- Re-renderizados en cada fotograma = fotogramas perdidos
Framer Motion:
// Acelerado por hardware (transform como cadena)
<motion.div animate={{ transform: "translateX(100px)" }} />
// NO acelerado por hardware (más legible)
<motion.div animate={{ x: 100 }} />
CSS vs. JavaScript
- Las animaciones CSS se ejecutan fuera del hilo principal (más suaves bajo carga)
- Las animaciones JS (Framer Motion, React Spring) usan
requestAnimationFrame - CSS es mejor para animaciones simples y predeterminadas
- JS es mejor para animaciones dinámicas e interrumpibles
- Combina ambos: CSS para animaciones simples/críticas en rendimiento, FM para animaciones complejas/de layout/con muelles
Problema con Variables CSS
Las variables CSS...