Implementación de Animaciones con Motion
Usa la librería Motion (https://motion.dev) para todo el trabajo de animación.
Inicio Rápido
React (Principal):
import { motion } from "motion/react"
// Animación básica
<motion.div animate={{ opacity: 1, y: 0 }} />
// Con configuración de transición
<motion.div
animate={{ x: 100 }}
transition={{ type: "spring", stiffness: 100 }}
/>
Patrones Principales
1. Física de Resorte (Preferida)
<motion.div
animate={{ scale: 1 }}
transition={{
type: 'spring',
stiffness: 260,
damping: 20,
}}
/>
Preajustes de resorte:
- Suave:
stiffness: 120, damping: 14 - Oscilante:
stiffness: 180, damping: 12 - Rígido:
stiffness: 300, damping: 20
2. Interacciones por Gesto
<motion.div
whileHover={{ scale: 1.05 }}
whileTap={{ scale: 0.95 }}
drag="x"
dragConstraints={{ left: -100, right: 100 }}
/>
3. Animaciones de Layout
<motion.div layout>{/* Contenido que cambia de posición/tamaño */}</motion.div>
4. Efectos Vinculados al Scroll
import { useScroll, useTransform } from "motion/react"
const { scrollYProgress } = useScroll()
const opacity = useTransform(scrollYProgress, [0, 1], [1, 0])
<motion.div style={{ opacity }} />
5. Escalonamiento de Hijos
<motion.ul
variants={{
visible: { transition: { staggerChildren: 0.07 } },
}}
>
{items.map((item) => (
<motion.li
key={item}
variants={{
hidden: { opacity: 0, y: 20 },
visible: { opacity: 1, y: 0 },
}}
/>
))}
</motion.ul>
6. Animaciones de Entrada/Salida
import { AnimatePresence } from 'motion/react';
<AnimatePresence>
{show && <motion.div initial={{ opacity: 0 }} animate={{ opacity: 1 }} exit={{ opacity: 0 }} />}
</AnimatePresence>;
Propiedades de Animación
Transformación (acelerada por GPU, eficiente):
x, y, z- Traslaciónscale, scaleX, scaleY- Escaladorotate, rotateX, rotateY, rotateZ- Rotaciónskew, skewX, skewY- Inclinación
Visual (usar con moderación, puede afectar el rendimiento):
opacitybackground, backgroundColorcolorborderRadius
Específicas de SVG:
pathLength- Para animaciones de dibujo de trazadospathOffset- Desplazamiento del trazadopathSpacing- Espaciado entre guiones
Accesibilidad
Respeta siempre las preferencias del usuario:
<motion.div
animate={{ x: 100 }}
transition={{
type: 'spring',
// Desactiva la animación si el usuario prefiere movimiento reducido
duration: 0,
}}
/>
Motion maneja automáticamente la preferencia prefers-reduced-motion. Los resortes se convierten en transiciones instantáneas.
Consejos de Rendimiento
- Anima solo transformaciones/opacidad cuando sea posible (acelerado por GPU)
- Usa la prop
layouten lugar de animar ancho/alto manualmente - Evita animar durante el scroll siempre que sea posible
- Usa
will-change: transformpara animaciones complejas (Motion lo maneja) - Limita las animaciones simultáneas - escalona en lugar de hacer todo a la vez
Principios de Diseño (Breve)
Cuándo Animar
- Transiciones de estado (cargando → éxito)
- Cambios espaciales (entrar/salir de la vista)
- Llamar la atención (con moderación)
- Confirmar la acción del usuario
Cuándo NO Animar
- Acciones repetidas después de la primera ocurrencia
- Rutas críticas para el rendimiento
- Scroll controlado por el usuario
- Cada interacción individual (la moderación importa)
Guías de Tiempo
- Micro-interacciones: 150-250ms
- Transiciones de panel/modal: 200-300ms
- Transiciones de página: 300-500ms
- Resortes: Deja que la física determine la duración
Resorte vs Duración
- Usa resortes para: Elementos interactivos, gestos, cambios de layout
- Usa duración para: Secuencias intencionadas, coreografía, cargadores
Consulta principles.md para una filosofía de animación detallada.
Patrones Comunes
Estado de carga:
<motion.div
animate={{ rotate: 360 }}
transition={{
repeat: Infinity,
duration: 1,
ease: 'linear',
}}
/>
Notificación tipo toast:
<motion.div
initial={{ x: 400, opacity: 0 }}
animate={{ x: 0, opacity: 1 }}
exit={{ x: 400, opacity: 0 }}
transition={{ type: 'spring', stiffness: 300, damping: 30 }}
/>
Panel lateral (drawer):
<motion.div
initial={{ x: '-100%' }}
animate={{ x: 0 }}
exit={{ x: '-100%' }}
transition={{ type: 'spring', damping: 25 }}
/>
Acordeón:
<motion.div
animate={{ height: isOpen ? 'auto' : 0 }}
transition={{ type: 'spring', bounce: 0 }}
style={{ overflow: 'hidden' }}
/>
Recursos
- Documentación de Motion: https://motion.dev/docs/react
- Ejemplos de Motion: https://motion.dev/examples (más de 100 ejemplos gratuitos)
- Repositorio de GitHub: https://github.com/motiondivision/motion
- Recursos adicionales: Consulta
resources.mdpara lecciones seleccionadas de animation.dev y la bóveda
Solución Rápida de Problemas
¿La animación no se ejecuta?
- Verifica si el elemento se renderiza condicionalmente (usa AnimatePresence)
- Confirma que los valores objetivo sean diferentes de los valores iniciales
- Comprueba si hay CSS que pueda anular (ej.,
!important)
¿Problemas de rendimiento?
- Limítate a transformaciones y opacidad
- Usa la prop
layouten lugar de animar dimensiones - Revisa la pestaña Rendimiento de las DevTools del navegador
¿Parpadeos en animaciones de layout?
- Asegúrate de que el padre tenga
position: relative - Añade
layouttanto al padre como al hijo si es necesario - Verifica si hay transiciones CSS conflictivas
Notas
- Motion tiene licencia MIT, lista para producción
- Motor híbrido: 120fps, acelerado por GPU
- Soporte integrado para TypeScript
- Tree-shakable para un tamaño de bundle óptimo
- Funciona con React 18+ (incluyendo Suspense)