Patrones de Movimiento UI
Dos tareas: animar la interfaz de producto real en la web y reconstruirla para video sin rediseñarla. Ambas usan los mismos tokens.
1. Tokens primero
Define el movimiento una vez e impórtalo en todas partes. Sin números inline en componentes.
// lib/motion-tokens.ts
export const motionTokens = {
duration: { instant: 0.1, fast: 0.18, normal: 0.3, slow: 0.5, scene: 0.7 },
easing: {
standard: [0.2, 0, 0, 1], // entrada + movimiento
exit: [0.4, 0, 1, 1], // salida
emphasized: [0.3, 0, 0, 1],
},
distance: { nudge: 4, small: 8, medium: 16, large: 32 },
stagger: 0.06, // mantener entre 0.05 y 0.10
} as const;
export const springs = {
press: { type: "spring", stiffness: 600, damping: 38 }, // botones, toggles
snappy: { type: "spring", stiffness: 420, damping: 34 }, // chips, menús
gentle: { type: "spring", stiffness: 260, damping: 27 }, // tarjetas, paneles
layout: { type: "spring", stiffness: 320, damping: 30 }, // reordenar, redimensionar
camera: { type: "spring", stiffness: 140, damping: 20 }, // movimientos grandes, solo video
} as const;
Con masa 1, relación de amortiguación ζ = damping / (2·√stiffness): press 0.78, snappy 0.83, gentle 0.84, layout 0.84, camera 0.85 — todos dentro de la banda 0.75–0.90 (sobreoscilación ≤ ~6 %). Ajusta por marca con esa fórmula y mantén esta tabla como fuente única.
2. Accesibilidad y SSR
"use client";
import { useReducedMotion } from "motion/react";
export function useSafeMotion() {
const reduce = useReducedMotion();
return {
reduce,
// movimiento reducido: eliminar transformaciones, mantener cambios cortos de opacidad (≤0.2 s)
enter: reduce ? { opacity: 1 } : { opacity: 1, y: 0 },
initial: reduce ? { opacity: 0 } : { opacity: 0, y: 8 },
transition: reduce ? { duration: 0.2 } : undefined,
};
}
- Usa
initial={false}para elementos ya visibles en el primer pintado para evitar parpadeos de hidratación. - Anima solo
transformyopacity. Nunca animeswidth,height,top,leftobox-shadowen bucles; usalayouto scale en su lugar. - Dispositivos de gama baja: acorta duraciones y omite movimiento decorativo.
3. Patrones y sus reglas
| Patrón | Regla |
|---|---|
| Presión de botón | whileTap={{ scale: 0.96 }} con springs.press; retroalimentación en 100 ms |
| Renderizado condicional | envolver en AnimatePresence con un key estable; cada initial + animate tiene un exit |
| Transición de página / ruta | AnimatePresence mode="wait": la salida se completa antes de que entre la nueva |
| Escalonado de lista | staggerChildren 0.05–0.10 s; limitar elementos escalonados a ~8, el resto aparece junto |
| Reordenar / redimensionar | layout en subárboles pequeños (≲5 hijos); de lo contrario usar x/y explícito |
| Modal / panel | trampa de foco, Escape cierra, bloqueo de scroll, role="dialog", aria-modal="true", devolver foco |
| Notificación | entra desde el borde donde vive; auto-descarte se pausa al pasar el ratón/enfocar |
| Cambio numérico | rollo vertical: el valor antiguo sale hacia arriba con desenfoque, el nuevo entra desde abajo; font-variant-numeric: tabular-nums |
| Revelación por scroll | whileInView con viewport={{ once: true }}; nunca re-animar al salir del viewport |
| Carga → éxito | botón se comprime → spinner → check; mantener el ancho del botón estable |
4. Reconstruir interfaz de producto para video
- Mide, no adivines. Toma tokens del código fuente del producto o de estilos computados: colores, radios, familia de fuente/pesos/tracking, espaciado, set de iconos y grosor. Muestrea colores de capturas reales y compara.
- Híbrido por defecto. Captura real como contexto; reconstruye solo los elementos que se animan, alineados a píxel sobre ella.
- Nunca rediseñes sin aprobación explícita. Sin nuevos colores, fuentes, iconos ni texto.
- Captura limpia. Sesión cerrada o cuenta demo, datos ficticios, sin PII, sin marcas de terceros a menos que el usuario sea propietario de ellas.
- Buscable. En video, maneja todo valor animado desde tiempo absoluto (
value = f(t)), no desde el estado runtime demotion/react. Usamotion/reactpara la web en vivo, resortes de forma cerrada o líneas de tiempo GSAP para video renderizado.
Cuando estos patrones se usen en un sitio web y no en un video, ejecuta la compuerta de verificación
design-expert (teclado, foco, movimiento reducido, rendimiento) antes de publicar.