Implementación de Animaciones con Motion
Use la librería Motion (https://motion.dev) para todo 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 Gestuales
<motion.div
whileHover={{ scale: 1.05 }}
whileTap={{ scale: 0.95 }}
drag="x"
dragConstraints={{ left: -100, right: 100 }}
/>
3. Animaciones de Diseño
<motion.div layout>{/* Contenido que cambia de posición/tamaño */}</motion.div>
4. Efectos Vinculados al Desplazamiento
import { useScroll, useTransform } from "motion/react"
const { scrollYProgress } = useScroll()
const opacity = useTransform(scrollYProgress, [0, 1], [1, 0])
<motion.div style={{ opacity }} />
5. Escalonar 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ífico de SVG:
pathLength- Para animaciones de dibujo de trayectoriaspathOffset- Desplazar la trayectoriapathSpacing- Espaciado entre guiones
Accesibilidad
Respete 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 prefers-reduced-motion. Los resortes se convierten en transiciones instantáneas.
Consejos de Rendimiento
- Anime solo transformaciones/opacidad cuando sea posible (acelerado por GPU)
- Use el prop
layouten lugar de animar ancho/alto manualmente - Evite animar durante el desplazamiento cuando sea posible
- Use
will-change: transformpara animaciones complejas (Motion lo maneja) - Limite animaciones simultáneas - escalone en lugar de hacer todo a la vez
Principios de Diseño (Breve)
Cuándo Anime
- Transiciones de estado (cargando → éxito)
- Cambios espaciales (entrar/salir de la vista)
- Llamar la atención (con moderación)
- Confirmar acción del usuario
Cuándo NO Anime
- Acciones repetidas después de la primera ocurrencia
- Rutas críticas para el rendimiento
- Desplazamiento controlado por el usuario
- Cada interacción individual (la moderación importa)
Pautas de Tiempo
- Microinteracciones: 150-250ms
- Transiciones de panel/modal: 200-300ms
- Transiciones de página: 300-500ms
- Resortes: Deje que la física determine la duración
Resorte vs Duración
- Use resortes para: Elementos interactivos, gestos, cambios de diseño
- Use duración para: Secuencias intencionales, coreografías, cargadores
Consulte principles.md para obtener una filosofía detallada de animación.
Patrones Comunes
Estado de carga:
<motion.div
animate={{ rotate: 360 }}
transition={{
repeat: Infinity,
duration: 1,
ease: 'linear',
}}
/>
Notificación 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 deslizante:
<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 extendidos: Consulte
resources.mdpara lecciones seleccionadas de animation.dev y vault
Solución Rápida de Problemas
¿La animación no se ejecuta?
- Verifique si el elemento se renderiza condicionalmente (use AnimatePresence)
- Asegúrese de que los valores objetivo sean diferentes de los valores iniciales
- Verifique si hay CSS que pueda sobrescribir (por ejemplo,
!important)
¿Problemas de rendimiento?
- Cíñase a transformaciones y opacidad
- Use el prop
layouten lugar de animar dimensiones - Revise la pestaña Rendimiento de las Herramientas de Desarrollo del navegador
¿Animaciones de diseño parpadean?
- Asegúrese de que el padre tenga
position: relative - Agregue
layouttanto al padre como al hijo si es necesario - Verifique si hay transiciones CSS conflictivas
Notas
- Motion tiene licencia MIT, listo para producción
- Motor híbrido: 120fps, acelerado por GPU
- Soporte integrado de TypeScript
- Tree-shakable para un tamaño de bundle óptimo
- Funciona con React 18+ (incluyendo Suspense)