Motion (Framer Motion) — Skill
Nombre: motion
Propósito: Implementar animaciones suaves y accesibles con motion/react en React.
Usa esta habilidad siempre que añadas animaciones, gestos o transiciones de diseño.
Aplica cuando: Usas motion/react (motion, AnimatePresence, useScroll, etc.).
No usar cuando: No se necesitan animaciones o el componente se renderiza estrictamente en servidor.
Reglas
- Límite solo cliente: Motion requiere
'use client'; mantén las islas de cliente pequeñas. - Empieza simple: Comienza con opacidad/traslación antes de añadir física de resortes.
- Usa la herramienta adecuada:
AnimatePresencepara entrada/salida,layoutpara diseño,whileHover/whileTappara gestos. - Respeta el movimiento reducido: Usa
useReducedMotion(). - Disciplina de tamaño: Usa
LazyMotionpara superficies de motion grandes.
Flujo de trabajo
- Identifica el propósito de UX (retroalimentación, transición, foco).
- Añade el límite
'use client'más pequeño. - Implementa correctamente las transiciones de entrada/salida o diseño.
- Respeta las preferencias de movimiento reducido.
- Verifica el rendimiento y el tamaño del paquete.
Listas de verificación
Lista de verificación de implementación
-
'use client'solo donde sea necesario - Comportamiento de movimiento reducido definido
-
AnimatePresenceenvuelve la UI condicional - Las transiciones de diseño usan
layout
Lista de verificación de revisión
- Las animaciones no se vuelven a ejecutar en cada renderizado
- El código de motion no expande innecesariamente el árbol de cliente
Ejemplos mínimos
Entrada/salida
"use client";
import { AnimatePresence, motion } from "motion/react";
export function Toast({
open,
children,
}: {
open: boolean;
children: React.ReactNode;
}) {
return (
<AnimatePresence>
{open ? (
<motion.div
initial={{ opacity: 0, y: 8 }}
animate={{ opacity: 1, y: 0 }}
exit={{ opacity: 0, y: 8 }}
transition={{ duration: 0.18 }}
>
{children}
</motion.div>
) : null}
</AnimatePresence>
);
}
Animación de diseño
"use client";
import { motion } from "motion/react";
export function Expander({ open }: { open: boolean }) {
return (
<motion.div layout className="overflow-hidden rounded-md border p-3">
<div className="font-medium">Título</div>
{open ? <div className="mt-2 text-sm">Más contenido...</div> : null}
</motion.div>
);
}
Movimiento reducido
"use client";
import { motion, useReducedMotion } from "motion/react";
export function FadeIn({ children }: { children: React.ReactNode }) {
const reduce = useReducedMotion();
return (
<motion.div
initial={reduce ? false : { opacity: 0, y: 6 }}
animate={reduce ? { opacity: 1 } : { opacity: 1, y: 0 }}
transition={{ duration: 0.2 }}
>
{children}
</motion.div>
);
}
Errores comunes / dificultades
- Desmontar sin
AnimatePresence(las animaciones de salida nunca se ejecutan) - Animar diseño sin
layout - Poner Motion en un árbol de cliente enorme
- Animar listas grandes sin virtualización