Motion (Framer Motion) — Biblioteca de Animação para React UI
Animações declarativas para React. Spring, gestos, animações de layout e transições de página. Acelerado por GPU, pronto para produção.
Visão Geral
- Repositório: github.com/motiondivision/motion (26K+ estrelas)
- Linguagem: TypeScript / React
- Licença: MIT
- Instalação:
npm install motion - Documentação: motion.dev
- Nota: Framer Motion foi renomeado para Motion. Importe de
motion/react.
API Principal
Animação Básica
import { motion } from "motion/react";
// Animar ao montar
<motion.div
initial={{ opacity: 0, y: 20 }}
animate={{ opacity: 1, y: 0 }}
transition={{ duration: 0.5 }}
>
Olá Mundo
</motion.div>
// Animar ao sair (requer AnimatePresence)
import { AnimatePresence } from "motion/react";
<AnimatePresence>
{isVisible && (
<motion.div
initial={{ opacity: 0 }}
animate={{ opacity: 1 }}
exit={{ opacity: 0 }}
>
Conteúdo
</motion.div>
)}
</AnimatePresence>
Física de Mola
<motion.div
animate={{ x: 100 }}
transition={{
type: "spring",
stiffness: 300,
damping: 20,
mass: 1,
}}
/>
// Presets
transition={{ type: "spring", bounce: 0.5 }} // 0 = sem bounce, 1 = muito elástico
Variantes (Animações Orquestradas)
const container = {
hidden: { opacity: 0 },
show: {
opacity: 1,
transition: {
staggerChildren: 0.1, // Atraso entre filhos
delayChildren: 0.3, // Atraso inicial
},
},
};
const item = {
hidden: { opacity: 0, y: 20 },
show: { opacity: 1, y: 0 },
};
<motion.ul variants={container} initial="hidden" animate="show">
{items.map((i) => (
<motion.li key={i} variants={item}>{i}</motion.li>
))}
</motion.ul>
Gestos
// Hover
<motion.button
whileHover={{ scale: 1.05 }}
whileTap={{ scale: 0.95 }}
>
Clique aqui
</motion.button>
// Arrastar
<motion.div
drag // Habilita arrastar em ambos os eixos
dragConstraints={{ left: -100, right: 100, top: -50, bottom: 50 }}
dragElastic={0.2}
/>
Animações de Layout
// Animar automaticamente mudanças de layout
<motion.div layout>
{isExpanded ? <ConteudoExpandido /> : <ConteudoRecolhido />}
</motion.div>
// Animação de layout compartilhada (morph entre elementos)
<motion.div layoutId="card">
{/* Este elemento faz morph entre posições quando layoutId corresponde */}
</motion.div>
Animações de Scroll
import { useScroll, useTransform, motion } from "motion/react";
function SecaoParalaxe() {
const { scrollYProgress } = useScroll();
const y = useTransform(scrollYProgress, [0, 1], [0, -200]);
const opacity = useTransform(scrollYProgress, [0, 0.5, 1], [1, 1, 0]);
return (
<motion.div style={{ y, opacity }}>
Conteúdo com paralaxe
</motion.div>
);
}
useAnimate (Imperativo)
import { useAnimate } from "motion/react";
function MeuComponente() {
const [scope, animate] = useAnimate();
async function handleClick() {
await animate(".box", { scale: 1.5 }, { duration: 0.3 });
await animate(".box", { rotate: 360 }, { duration: 0.5 });
await animate(".box", { scale: 1, rotate: 0 });
}
return (
<div ref={scope}>
<div className="box" onClick={handleClick}>Clique aqui</div>
</div>
);
}
Keyframes
<motion.div
animate={{
x: [0, 100, 100, 0, 0],
y: [0, 0, 100, 100, 0],
rotate: [0, 90, 180, 270, 360],
}}
transition={{ duration: 2, repeat: Infinity }}
/>
Tipos de Transição
// Spring (padrão para valores físicos)
transition={{ type: "spring", stiffness: 100, damping: 10 }}
// Tween (baseado em duração)
transition={{ type: "tween", duration: 0.5, ease: "easeInOut" }}
// Opções de easing
ease: "linear" | "easeIn" | "easeOut" | "easeInOut"
ease: [0.42, 0, 0.58, 1] // Cubic bezier personalizado
// Repetir
transition={{ repeat: Infinity, repeatType: "reverse", duration: 1 }}
// Atraso
transition={{ delay: 0.5 }}
Padrões Comuns
Transição de Página
// No componente de layout
<AnimatePresence mode="wait">
<motion.div
key={pathname}
initial={{ opacity: 0, x: 20 }}
animate={{ opacity: 1, x: 0 }}
exit={{ opacity: 0, x: -20 }}
transition={{ duration: 0.3 }}
>
{children}
</motion.div>
</AnimatePresence>
Lista Escalonada
const container = {
hidden: {},
show: { transition: { staggerChildren: 0.08 } },
};
const item = {
hidden: { opacity: 0, y: 15 },
show: { opacity: 1, y: 0, transition: { type: "spring", bounce: 0.3 } },
};
Cartão com Escala ao Hover
<motion.div
whileHover={{ scale: 1.03, boxShadow: "0 10px 30px rgba(0,0,0,0.15)" }}
transition={{ type: "spring", stiffness: 400, damping: 25 }}
/>
Melhores Práticas
- Use variantes para animações orquestradas de pais/filhos
- Física de mola para movimentos com sensação natural (evite easing linear)
- Prop layout para animações automáticas de mudanças de layout
- AnimatePresence necessário para animações de saída
- layoutId para transições de elementos compartilhados entre rotas
- useScroll para animações vinculadas ao scroll (paralaxe, barras de progresso)
- whileHover/whileTap para feedback interativo
- Escalonar filhos via
transition.staggerChildrenda variante - Mantenha as animações sutis — duração de 0.2-0.5s para interações de UI
- Acelerado por GPU — Motion usa transformações por padrão
Quando Usar Motion vs GSAP
| Motion | GSAP | |
|---|---|---|
| Framework | Primeiro React | Agnóstico de framework |
| Estilo | Declarativo (props JSX) | Imperativo (chamadas de função) |
| Animações de layout | Integrado (mágico) | Manual |
| Scroll | Hook useScroll | Plugin ScrollTrigger |
| Gestos | Integrado (arrastar, hover, toque) | Plugin Draggable |
| Morphing SVG | Limitado | Plugin MorphSVG |
| Tamanho do bundle | ~30KB | ~25KB core |
Fonte
- Repositório: github.com/motiondivision/motion
- Documentação: motion.dev
- Exemplos: motion.dev/docs/react-quick-start