Implementação de Animações com Motion
Use a biblioteca Motion (https://motion.dev) para todo trabalho de animação.
Início Rápido
React (Principal):
import { motion } from "motion/react"
// Animação básica
<motion.div animate={{ opacity: 1, y: 0 }} />
// Com configuração de transição
<motion.div
animate={{ x: 100 }}
transition={{ type: "spring", stiffness: 100 }}
/>
Padrões Principais
1. Física de Mola (Preferencial)
<motion.div
animate={{ scale: 1 }}
transition={{
type: 'spring',
stiffness: 260,
damping: 20,
}}
/>
Predefinições de mola:
- Suave:
stiffness: 120, damping: 14 - Oscilante:
stiffness: 180, damping: 12 - Rígida:
stiffness: 300, damping: 20
2. Interações por Gestos
<motion.div
whileHover={{ scale: 1.05 }}
whileTap={{ scale: 0.95 }}
drag="x"
dragConstraints={{ left: -100, right: 100 }}
/>
3. Animações de Layout
<motion.div layout>{/* Conteúdo que muda de posição/tamanho */}</motion.div>
4. Efeitos Vinculados à Rolagem
import { useScroll, useTransform } from "motion/react"
const { scrollYProgress } = useScroll()
const opacity = useTransform(scrollYProgress, [0, 1], [1, 0])
<motion.div style={{ opacity }} />
5. Escalonamento de Filhos (Stagger)
<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. Animações de Entrada/Saída
import { AnimatePresence } from 'motion/react';
<AnimatePresence>
{show && <motion.div initial={{ opacity: 0 }} animate={{ opacity: 1 }} exit={{ opacity: 0 }} />}
</AnimatePresence>;
Propriedades de Animação
Transformação (Acelerado por GPU, performático):
x, y, z- Translaçãoscale, scaleX, scaleY- Escalarotate, rotateX, rotateY, rotateZ- Rotaçãoskew, skewX, skewY- Distorção
Visual (Use com moderação, pode afetar desempenho):
opacitybackground, backgroundColorcolorborderRadius
Específico para SVG:
pathLength- Para animações de desenho de caminhopathOffset- Deslocar o caminhopathSpacing- Espaçamento entre traços
Acessibilidade
Sempre respeite as preferências do usuário:
<motion.div
animate={{ x: 100 }}
transition={{
type: 'spring',
// Desativa animação se o usuário preferir movimento reduzido
duration: 0,
}}
/>
Motion lida automaticamente com prefers-reduced-motion. Molas se tornam transições instantâneas.
Dicas de Desempenho
- Anime apenas transformações/opacidade quando possível (acelerado por GPU)
- Use a propriedade
layoutem vez de animar largura/altura manualmente - Evite animar durante rolagem quando possível
- Use
will-change: transformpara animações complexas (Motion cuida disso) - Limite animações simultâneas - escalone em vez de todas de uma vez
Princípios de Design (Resumido)
Quando Animar
- Transições de estado (carregando → sucesso)
- Mudanças espaciais (entrando/saindo da visualização)
- Chamar atenção (com moderação)
- Confirmar ação do usuário
Quando NÃO Animar
- Ações repetidas após a primeira ocorrência
- Caminhos críticos para desempenho
- Rolagem controlada pelo usuário
- Cada interação individual (moderação é importante)
Diretrizes de Temporização
- Micro-interações: 150-250ms
- Transições de painel/modal: 200-300ms
- Transições de página: 300-500ms
- Molas: Deixe a física determinar a duração
Mola vs Duração
- Use molas para: Elementos interativos, gestos, mudanças de layout
- Use duração para: Sequências intencionais, coreografia, carregadores
Consulte principles.md para a filosofia detalhada de animação.
Padrões Comuns
Estado de carregamento:
<motion.div
animate={{ rotate: 360 }}
transition={{
repeat: Infinity,
duration: 1,
ease: 'linear',
}}
/>
Notificação 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 }}
/>
Gaveta (drawer):
<motion.div
initial={{ x: '-100%' }}
animate={{ x: 0 }}
exit={{ x: '-100%' }}
transition={{ type: 'spring', damping: 25 }}
/>
Acordeão:
<motion.div
animate={{ height: isOpen ? 'auto' : 0 }}
transition={{ type: 'spring', bounce: 0 }}
style={{ overflow: 'hidden' }}
/>
Recursos
- Documentação Motion: https://motion.dev/docs/react
- Exemplos Motion: https://motion.dev/examples (mais de 100 exemplos gratuitos)
- Repositório GitHub: https://github.com/motiondivision/motion
- Recursos estendidos: Consulte
resources.mdpara lições selecionadas do animation.dev e vault
Solução de Problemas Rápida
Animação não está rodando?
- Verifique se o elemento é renderizado condicionalmente (use AnimatePresence)
- Verifique se os valores de destino são diferentes dos valores iniciais
- Verifique se há CSS que pode sobrescrever (ex.:
!important)
Problemas de desempenho?
- Atenha-se a transformações e opacidade
- Use a propriedade
layoutem vez de animar dimensões - Verifique a aba de Desempenho nas Ferramentas do Desenvolvedor do navegador
Animações de layout piscando?
- Garanta que o pai tenha
position: relative - Adicione
layoutao pai e ao filho, se necessário - Verifique conflitos com transições CSS existentes
Notas
- Motion é licenciado sob MIT, pronto para produção
- Mecanismo híbrido: 120fps, acelerado por GPU
- Suporte a TypeScript integrado
- Tree-shakable para tamanho de bundle otimizado
- Funciona com React 18+ (incluindo Suspense)