Design de Animações Web
⚠️ Pacote Criativo — NÃO aplicar automaticamente
Esta skill faz parte do pacote criativo. Use quando a tarefa envolver explicitamente animação, movimento ou sensação de interação. NÃO carregue esta skill para construção de UI genérica — a referência de movimento no design-review cobre a qualidade básica de movimento.
Use quando: o usuário perguntar sobre animações, easing, molas, transições, sensação de interação ou "deixar suave". Pule quando: estiver construindo UI padrão onde a referência de movimento no design-review é suficiente.
Um guia abrangente para criar animações que parecem certas, baseado no curso "Animations on the Web" de Emil Kowalski.
Resposta Inicial
Quando esta skill for invocada pela primeira vez sem uma pergunta específica, responda apenas com:
Estou pronto para ajudar com animações baseadas no curso animations.dev de Emil Kowalski.
Não forneça nenhuma outra informação até que o usuário faça uma pergunta.
Formato de Revisão (Obrigatório)
Ao revisar animações, você DEVE usar uma tabela markdown. NÃO use uma lista com "Antes:" e "Depois:" em linhas separadas. Sempre produza uma tabela markdown real como esta:
| Antes | Depois |
|---|---|
transform: scale(0) | transform: scale(0.95) |
animation: fadeIn 400ms ease-in | animation: fadeIn 200ms ease-out |
| Sem suporte a movimento reduzido | @media (prefers-reduced-motion: reduce) {...} |
Formato errado (nunca faça isso):
Antes: transform: scale(0)
Depois: transform: scale(0.95)
────────────────────────────
Antes: duração de 400ms
Depois: 200ms
Formato correto: Uma única tabela markdown com colunas | Antes | Depois |, uma linha por problema.
Árvore de Decisão: Qual Ferramenta Usar?
Isso envolve mudanças de layout, transições compartilhadas ou animações de saída em React?
├── Sim → Framer Motion (animações de layout, AnimatePresence, layoutId)
│ Importar de "motion/react" (NÃO de "framer-motion")
└── Não
├── É uma entrada/saída simples ou hover? → Transições/Keyframes CSS
├── É crítico para desempenho (página pesada, muitos elementos)? → CSS (acelerado por hardware)
├── Precisa de física de mola ou interrompibilidade? → Framer Motion
├── Precisa de rastreamento de gestos (arrastar, seguir cursor)? → Valores de movimento FM
└── É um loop de velocidade constante? → Keyframes CSS
Sempre verifique prefers-reduced-motion. Sem exceções.
Início Rápido
Toda decisão de animação começa com estas perguntas:
- Este elemento está entrando ou saindo? → Use
ease-out - É um elemento já na tela que está se movendo? → Use
ease-in-out - É uma transição de hover/cor? → Use
ease - Os usuários verão isso 100+ vezes por dia? → Não anime
O Modelo de Easing
ease-out (Mais Comum)
Use para interações iniciadas pelo usuário: menus suspensos, modais, tooltips, qualquer elemento entrando ou saindo da tela.
/* Ordenado do fraco ao forte */
--ease-out-quad: cubic-bezier(0.25, 0.46, 0.45, 0.94);
--ease-out-cubic: cubic-bezier(0.215, 0.61, 0.355, 1);
--ease-out-quart: cubic-bezier(0.165, 0.84, 0.44, 1);
--ease-out-quint: cubic-bezier(0.23, 1, 0.32, 1);
--ease-out-expo: cubic-bezier(0.19, 1, 0.22, 1);
--ease-out-circ: cubic-bezier(0.075, 0.82, 0.165, 1);
Por que funciona: A aceleração no início cria uma sensação instantânea e responsiva. O elemento "salta" em direção ao seu destino e depois se acomoda.
ease-in-out (Para Movimento)
Use quando elementos já na tela precisam se mover ou transformar. Imita o movimento natural, como um carro acelerando e depois freando.
/* Ordenado do fraco ao forte */
--ease-in-out-quad: cubic-bezier(0.455, 0.03, 0.515, 0.955);
--ease-in-out-cubic: cubic-bezier(0.645, 0.045, 0.355, 1);
--ease-in-out-quart: cubic-bezier(0.77, 0, 0.175, 1);
--ease-in-out-quint: cubic-bezier(0.86, 0, 0.07, 1);
--ease-in-out-expo: cubic-bezier(1, 0, 0, 1);
--ease-in-out-circ: cubic-bezier(0.785, 0.135, 0.15, 0.86);
ease (Para Efeitos de Hover)
Use para estados de hover e transições de cor. A curva assimétrica (início mais rápido, final mais lento) parece elegante para animações suaves.
transition: background-color 150ms ease;
linear (Evite em UI)
Use apenas para:
- Animações de velocidade constante (marquees, tickers)
- Visualização de tempo (indicadores de progresso "segure para deletar")
Linear parece robótico e não natural para elementos interativos.
ease-in (Quase Nunca)
Evite para animações de UI. Torna as interfaces lentas porque o início lento atrasa o feedback visual.
Regra de Elementos Pareados
Elementos que animam juntos devem usar o mesmo easing e duração. Modal + overlay, tooltip + seta, drawer + backdrop — se eles se movem como uma unidade, devem parecer uma unidade.
/* Ambos usam a mesma temporização */
.modal {
transition: transform 200ms ease-out;
}
.overlay {
transition: opacity 200ms ease-out;
}
Temporização e Duração
Diretrizes de Duração
| Tipo de Elemento | Duração |
|---|---|
| Microinterações | 100-150ms |
| UI padrão (tooltips, menus suspensos) | 150-250ms |
| Modais, drawers | 200-300ms |
Regras:
- Animações de UI devem ficar abaixo de 300ms
- Elementos maiores animam mais devagar que os menores
- Animações de saída podem ser ~20% mais rápidas que as de entrada
- Combine duração com distância - maior distância = maior duração
A Frequência
Determine com que frequência os usuários verão a animação:
- 100+ vezes/dia → Sem animação (ou drasticamente reduzida)
- Uso ocasional → Animação padrão
- Raro/primeira vez → Pode ser mais especial
Exemplo: Raycast nunca anima porque os usuários abrem centenas de vezes por dia.
Quando Animar
Anime:
- Transições de entrada/saída para consistência espacial
- Mudanças de estado que se beneficiam de continuidade visual
- Respostas a ações do usuário (feedback)
- Interações raramente usadas onde o encantamento agrega valor
Não anime:
- Ações iniciadas pelo teclado
- Efeitos de hover em elementos usados com frequência
- Qualquer coisa com que os usuários interajam 100+ vezes por dia
- Quando a velocidade importa mais que a suavidade
Marketing vs. Produto:
- Marketing: Mais elaborado, durações maiores permitidas
- Produto: Rápido, proposital, nunca frívolo
Animações Spring (Mola)
Springs parecem mais naturais porque não têm durações fixas — elas simulam física real.
Quando Usar Springs
- Interações de arrastar com impulso
- Elementos que devem parecer "vivos" (Dynamic Island)
- Gestos que podem ser interrompidos no meio da animação
- Interfaces orgânicas e lúdicas
Configuração
Abordagem da Apple (recomendada):
// Duração + bounce (mais fácil de entender)
{ type: "spring", duration: 0.5, bounce: 0.2 }
Física tradicional:
// Massa, rigidez, amortecimento (mais complexo)
{ type: "spring", mass: 1, stiffness: 100, damping: 10 }
Diretrizes de Bounce
- Evite bounce na maioria dos contextos de UI
- Use bounce para arrastar para dispensar, interações lúdicas
- Mantenha o bounce sutil (0.1-0.3) quando usado
Interrompibilidade
Springs mantêm a velocidade quando interrompidas — animações CSS reiniciam do zero. Isso torna as springs ideais para gestos que os usuários podem mudar no meio do movimento.
Animações de Layout (Framer Motion)
O recurso FM mais poderoso. Permite animar propriedades que o CSS não consegue: flex-direction, justify-content, mudanças de posição.
A Prop layout
Adicione layout a qualquer elemento motion.* para animar automaticamente as mudanças de layout:
<motion.div layout className="element" />
Quando o tamanho ou a posição deste elemento mudar (devido a estado, conteúdo, irmãos), o FM anima suavemente. Sem medição manual necessária.
Animações de Layout Compartilhado (layoutId)
Conecte dois elementos separados para que um se transforme no outro:
// Destaque de aba — renderizado apenas para a aba ativa
{activeTab === tab ? (
<motion.div layoutId="tab-indicator" className="highlight" />
) : null}
Casos de uso: destaques de aba, expansão de cartão → modal, transformação de botão → popover, interação de lixeira (imagens se movem entre contêineres).
Truque criativo: layoutId cria ilusões. O "placeholder" do popover de feedback é na verdade um <span> com um layoutId compartilhado — não um placeholder de textarea real. Ele se transforma de texto de botão em texto de popover.
Animação de Altura Dinâmica
O FM não pode animar auto para auto. Use react-use-measure:
import useMeasure from "react-use-measure";
const [ref, bounds] = useMeasure();
<motion.div animate={{ height: bounds.height }}>
<div ref={ref}>{dynamicContent}</div>
</motion.div>
AnimatePresence (Aprofundado)
Modos
"sync"(padrão) — entrada e saída tocam simultaneamente"wait"— a saída é concluída antes da entrada começar (troca de ícone copiar/verificar)"popLayout"— remove o elemento de saída do fluxo de layout imediatamente (geralmente a escolha certa para UIs que se transformam)
Transições com Consciência de Direção
Use a prop custom para passar dados dinâmicos para componentes de saída (cujo estado está obsoleto):
<AnimatePresence mode="popLayout" custom={direction}>
<motion.div
key={step}
custom={direction}
initial="enter"
animate="center"
exit="exit"
variants={{
enter: (dir) => ({ x: dir > 0 ? 100 : -100, opacity: 0 }),
center: { x: 0, opacity: 1 },
exit: (dir) => ({ x: dir > 0 ? -100 : 100, opacity: 0 }),
}}
/>
</AnimatePresence>
Regras Principais
- Sempre adicione a prop
keyem elementos animados dentro de AnimatePresence - Use
initial={false}para pular a animação de montagem (trocas de ícone, estados de botão) - Bug conhecido: a alternância rápida pode mostrar ambos os elementos — fixe no FM v11.0.10 se isso acontecer
Valores de Movimento & Hooks
Os valores de movimento são atualizados fora do ciclo de renderização do React — sem re-renderizações, 60fps.
useMotionValue — Atualizações instantâneas (gestos)
const x = useMotionValue(0);
// Atualize via x.set(newValue), leia via x.get()
<motion.div style={{ x }} />
Use para: rastreamento direto de gestos (distância de arrasto → escala), qualquer mapeamento 1:1 onde o atraso da spring pareceria desconectado.
useSpring — Atualizações animadas (seguir atrás)
const x = useSpring(0, { mass: 0.1, damping: 16, stiffness: 71 });
// x.set(newValue) anima até ele com física de spring
Use para: seguidores de cursor, efeitos de impulso, qualquer coisa que deva rastrear atrás da entrada.
useTransform — Mapear um valor para outro
// Mapeamento de intervalo: posição y [0, 300] → escala [1, 1.5]
const scale = useTransform(y, [0, 300], [1, 1.5]);
// Forma de função: formatar um valor
const display = useTransform(angle, v => `${Math.round(v)}°`);
Use para: efeitos vinculados à rolagem, efeitos de distância do cursor, formatação de valor.
useMotionTemplate — Interpolação de string com valores de movimento
const clipPath = useMotionTemplate`inset(0px ${percent}% 0px 0px)`;
<motion.div style={{ clipPath }} />
MotionConfig — Transições padrão para uma subárvore
<MotionConfig transition={{ type: "spring", duration: 0.5, bounce: 0.2 }}>
{/* Todos os filhos usam essa transição, a menos que substituída */}
</MotionConfig>
Orquestração (Stagger & Sequenciamento)
Animações de entrada escalonadas criam um efeito de onda. Tente e erre até que pareça certo — não há fórmula.
Stagger CSS (sem biblioteca):
.item { animation: fadeSlideIn 400ms ease-out both; }
.item:nth-child(1) { animation-delay: 0ms; }
.item:nth-child(2) { animation-delay: 50ms; }
.item:nth-child(3) { animation-delay: 100ms; }
/* etc. */
Stagger FM:
const container = {
animate: { transition: { staggerChildren: 0.05 } }
};
const item = {
initial: { opacity: 0, y: 20 },
animate: { opacity: 1, y: 0 }
};
Regras:
- Mantenha os atrasos pequenos (30-80ms entre itens)
- Limite o tempo total da sequência — 10 itens a 80ms cada = 800ms, muito lento
- Páginas de marketing podem ser mais elaboradas; UI de produto deve ser rápida
Expressão de Marca Através da Velocidade de Animação
A temporização da animação É a identidade da marca:
- Marca de velocidade (Vercel): instantânea ou muito rápida, easing mínimo. "Não perdemos seu tempo."
- Marca premium (Stripe): mais lenta, mais deliberada. Curva
ease(não ease-out) para elegância. - Marca lúdica (Family): springs com bounce sutil, transformação fluida.
- UI de produto geralmente deve parecer rápida, independentemente da marca.
- Páginas de marketing são onde você expressa a personalidade da marca através do movimento.
Interfaces Fluidas (Aspiracional)
A estrela do norte: nada "aparece" ou "desaparece" — tudo se transforma. Family (iOS) é o padrão ouro.
- Animações de layout compartilhado são a ferramenta mais próxima da fluidez nativa na web
- Movimento fluido melhora a percepção de desempenho (parece mais rápido mesmo com o mesmo tempo de carregamento)
- Pense sobre animações ANTES de projetar a UI — posicione elementos para permitir transições perfeitas
- Atualmente difícil na web, mas é a direção para onde tudo está caminhando
- Transformação de texto (por exemplo, alteração de rótulo de botão) destaca mudanças de estado sutilmente
Desempenho
A Regra de Ouro
Anime apenas transform e opacity. Eles pulam as etapas de layout e pintura, executando inteiramente na GPU.
Evite animar:
padding,margin,height,width(acionam layout)- Filtros
bluracima de 20px (caros, especialmente no Safari) - Variáveis CSS em árvores de componentes profundas
Técnicas de Otimização
/* Força aceleração da GPU */
.animated-element {
will-change: transform;
}
Específico do React:
- Anime fora do ciclo de renderização do React quando possível
- Use refs para atualizar estilos diretamente em vez de estado
- Re-renderizações em cada quadro = quadros perdidos
Framer Motion:
// Acelerado por hardware (transform como string)
<motion.div animate={{ transform: "translateX(100px)" }} />
// NÃO acelerado por hardware (mais legível)
<motion.div animate={{ x: 100 }} />
CSS vs. JavaScript
- Animações CSS são executadas fora da thread principal (mais suaves sob carga)
- Animações JS (Framer Motion, React Spring) usam
requestAnimationFrame - CSS é melhor para animações simples e predeterminadas
- JS é melhor para animações dinâmicas e interrompíveis
- Combine ambos: CSS para animações simples/críticas para desempenho, FM para complexas/layout/molares
Armadilha das Variáveis CSS
Variáveis CSS
… [truncado para tradução]