Agregar Animaciones (OBLIGATORIO)
Cada componente DEBE tener animaciones de Framer Motion.
FLUJO DE TRABAJO APEX
Fase 0: ANALIZAR ANIMACIONES EXISTENTES
Tarea: explorar-código-base
Indicación: "Encuentra patrones de Framer Motion existentes: variantes, temporización,
easing, efectos hover. Reporta las convenciones de animación."
REGLAS: Coincidir con los patrones de animación existentes O proponer una migración.
Patrones Estándar
Contenedor + Escalonado (REQUERIDO)
import { motion } from "framer-motion";
const contenedor = {
oculto: { opacity: 0 },
mostrar: { opacity: 1, transition: { staggerChildren: 0.1 } }
};
const elemento = {
oculto: { opacity: 0, y: 20 },
mostrar: { opacity: 1, y: 0 }
};
<motion.div variants={contenedor} initial="oculto" animate="mostrar">
<motion.div variants={elemento}>Elemento 1</motion.div>
<motion.div variants={elemento}>Elemento 2</motion.div>
</motion.div>
Efectos Hover (REQUERIDO)
// Hover en tarjeta
<motion.div whileHover={{ y: -4 }} transition={{ duration: 0.2 }}>
// Hover en botón
<motion.button
whileHover={{ scale: 1.02 }}
whileTap={{ scale: 0.98 }}
>
Animación de Scroll
<motion.div
initial={{ opacity: 0, y: 40 }}
whileInView={{ opacity: 1, y: 0 }}
viewport={{ once: true, margin: "-100px" }}
/>
Directrices de Temporización
| Interacción | Duración | Easing |
|---|---|---|
| Hover | 50-100ms | ease-out |
| Presión de botón | 100-150ms | ease-out |
| Apertura de modal | 200-300ms | ease-out |
| Transición de página | 300-400ms | ease-in-out |
PROHIBIDO
// ❌ Bucles de rebote aleatorios
animate={{ y: [0, -10, 0] }}
transition={{ repeat: Infinity }}
// ❌ Efectos excesivos
whileHover={{ scale: 1.2, rotate: 5 }}
// ❌ Animaciones lentas
transition={{ duration: 1.5 }}
Accesibilidad (OBLIGATORIO)
import { useReducedMotion } from "framer-motion";
function Componente() {
const debeReducir = useReducedMotion();
return (
<motion.div
animate={debeReducir ? {} : { y: 0 }}
transition={debeReducir ? { duration: 0 } : { duration: 0.3 }}
/>
);
}
Validación
[ ] Animaciones existentes analizadas (Fase 0)
[ ] Patrones coinciden con los existentes O migración propuesta
[ ] Escalonado en listas/cuadrículas
[ ] Hover en todos los elementos interactivos
[ ] prefers-reduced-motion respetado
[ ] Sin animaciones excesivas/aleatorias
Referencias
- APEX Motion:
references/design/05-add-motion.md - Patrones de Movimiento:
references/motion-patterns.md