Melhores Práticas de Animação de Emil Kowalski
Guia completo de animação para interfaces web baseado nos ensinamentos de Emil Kowalski, bibliotecas open-source (Sonner, Vaul) e seu curso animations.dev. Contém 43 regras em 7 categorias, priorizadas por impacto.
Quando Aplicar
Consulte estas diretrizes ao:
- Adicionar animações a componentes React
- Escolher curvas de easing ou valores de temporização
- Implementar interações baseadas em gestos (deslizar, arrastar)
- Construir componentes de notificações toast ou gavetas
- Otimizar o desempenho de animações
- Garantir a acessibilidade de animações
Categorias de Regras por Prioridade
| Prioridade | Categoria | Impacto | Prefixo |
|---|---|---|---|
| 1 | Seleção de Easing | CRÍTICO | ease- |
| 2 | Temporização e Duração | CRÍTICO | timing- |
| 3 | Seleção de Propriedades | ALTO | props- |
| 4 | Técnicas de Transformação | ALTO | transform- |
| 5 | Padrões de Interação | MÉDIO-ALTO | interact- |
| 6 | Animação Estratégica | MÉDIO | strategy- |
| 7 | Acessibilidade e Polimento | MÉDIO | polish- |
Referência Rápida
1. Seleção de Easing (CRÍTICO)
ease-out-default- Use ease-out como easing padrãoease-custom-curves- Use cubic-bezier personalizado em vez do CSS embutidoease-in-out-onscreen- Use ease-in-out para movimento na telaease-spring-natural- Use animações spring para movimento naturalease-ios-drawer- Use easing estilo iOS para componentes de gavetaease-context-matters- Combine o easing ao contexto da animação
2. Temporização e Duração (CRÍTICO)
timing-300ms-max- Mantenha animações de UI abaixo de 300mstiming-faster-better- Animações mais rápidas melhoram o desempenho percebidotiming-asymmetric- Use temporização assimétrica para pressionar e soltartiming-tooltip-delay- Atrase tooltips iniciais, instantâneos subsequentestiming-drawer-500ms- Use duração de 500ms para animações de gaveta
3. Seleção de Propriedades (ALTO)
props-transform-opacity- Animar apenas transform e opacityprops-hardware-accelerated- Use animações aceleradas por hardware quando a thread principal estiver ocupadaprops-will-change- Use will-change para evitar deslocamento de 1pxprops-avoid-css-variables- Evite variáveis CSS para animações de arrastarprops-clip-path-performant- Use clip-path para revelações sem layout
4. Técnicas de Transformação (ALTO)
transform-scale-097- Escalone botões para 0.97 ao pressionartransform-never-scale-zero- Nunca anime a partir de scale(0)transform-percentage-translate- Use valores percentuais para translateYtransform-origin-aware- Torne as animações conscientes da origemtransform-scale-children- Transformações de escala afetam os filhostransform-3d-preserve- Use preserve-3d para efeitos de transformação 3D
5. Padrões de Interação (MÉDIO-ALTO)
interact-interruptible- Torne as animações interrompíveisinteract-momentum-dismiss- Use dispensa baseada em momentuminteract-damping- Amorteça o arrasto nos limitesinteract-scroll-drag-conflict- Resolva conflitos entre rolagem e arrastointeract-snap-points- Implemente pontos de encaixe com consciência de velocidadeinteract-friction-upward- Permita arrasto para cima com atritointeract-pointer-capture- Use captura de ponteiro para operações de arrasto
6. Animação Estratégica (MÉDIO)
strategy-keyboard-no-animate- Nunca anime ações iniciadas por tecladostrategy-frequency-matters- Considere a frequência de interação antes de animarstrategy-purpose-required- Toda animação deve ter um propósitostrategy-feedback-immediate- Forneça feedback imediato em todas as açõesstrategy-marketing-exception- Sites de marketing são a exceção
7. Acessibilidade e Polimento (MÉDIO)
polish-reduced-motion- Respeite prefers-reduced-motionpolish-opacity-fallback- Use opacity como fallback para movimento reduzidopolish-framer-hook- Use o hook useReducedMotion no Framer Motionpolish-dont-remove-all- Não remova toda a animação para movimento reduzidopolish-blur-bridge- Use blur para pontuar estados de animaçãopolish-clip-path-tabs- Use clip-path para transições de abaspolish-toast-stacking- Implemente empilhamento de toasts com escala e deslocamentopolish-scroll-reveal- Dispare animações de rolagem no limite apropriadopolish-hover-gap-fill- Preencha lacunas entre elementos hoveráveispolish-stagger-children- Escalone animações de filhos para orquestração
Referência de Valores Chave
| Valor | Uso |
|---|---|
cubic-bezier(0.32, 0.72, 0, 1) | Animação de gaveta/folha estilo iOS |
scale(0.97) | Feedback de pressão de botão |
scale(0.95) | Escala mínima de entrada (nunca scale(0)) |
200ms ease-out | Transição padrão de UI |
300ms | Duração máxima para animações de UI |
500ms | Duração de animação de gaveta |
0.11 px/ms | Limiar de velocidade para dispensa por momentum |
100px | Limiar do viewport para revelação por rolagem |
14px | Deslocamento de empilhamento de toast |
Arquivos de Referência
| Arquivo | Descrição |
|---|---|
| references/_sections.md | Definições e ordem das categorias |
| assets/templates/_template.md | Modelo para novas regras |
| metadata.json | Informações de versão e referência |