Animações com Motion Dev
Motion.dev - Mais de 10 milhões de downloads/mês, sucessor do Framer Motion Animações aceleradas por GPU a 120fps para React, Next.js, Svelte, Astro, Vue
Propósito
Gerar animações de nível de produção usando Motion.dev seguindo os princípios da Apple/Jon Ive: Proposital (serve à função) | Suave (120fps) | Acessível (movimento reduzido) | Performático (apenas GPU) | Elegante (sutil) | Consistente (temporização unificada)
Quando Usar
✅ Use para:
- Implementação de animações em React 19+/Next.js 15+/Svelte 5+/Astro 4+
- Efeitos de scroll (parallax, revelação), gestos (hover, drag, tap), animações de layout
- Seções de herói, cards, micro-interações que exigem desempenho de 60fps+
- Projetos que precisam de física spring, movimento natural, acessibilidade
❌ Não use para:
- Transições CSS-only (use a propriedade
transitionnativa) - Sites estáticos sem frameworks JavaScript
- Projetos Vue (use o pacote
motion-v- API diferente) - Animações complexas SVG/Canvas (GSAP é mais adequado)
- Apps CRUD sem formulários (exagerado)
Fluxo de Trabalho: Clarificar → Planejar → Implementar → Verificar
Etapa 1: Clarificar Requisitos
Determine o contexto do projeto e os objetivos da animação:
- Framework (React 19+, Next.js 15+, Svelte 5+, Astro 4+)
- Tipo de animação (entrada, gesto, scroll, layout)
- Objetivo de design (sutil, proeminente, lúdico, profissional)
- Restrições de desempenho (dispositivo alvo, limites de bundle, requisitos de acessibilidade)
- Mecanismo de disparo (montagem, viewport, interação do usuário)
Etapa 2: Planejar Estratégia de Animação
Defina a abordagem de implementação:
- Componentes a animar (cabeçalhos, cards, botões, seções)
- Padrões de movimento (fade, slide, escala, spring, parallax)
- Especificações de temporização (duração, atraso, intervalos de stagger)
- Parâmetros de física (stiffness: 300-400, damping: 20, mass: 1)
- Alternativas de acessibilidade (alternativas para prefers-reduced-motion)
Etapa 3: Implementar em Fases
Construa as animações incrementalmente:
- Configuração: Instalar Motion.dev, configurar imports, preparar estrutura do componente
- Animação Principal: Aplicar propriedades de movimento (initial, animate, transition)
- Refinamento: Ajustar temporização, curvas de easing, física spring para sensação natural
- Acessibilidade: Adicionar detecção de movimento reduzido, suporte a navegação por teclado
- Otimização: Verificar aceleração GPU, minimizar tamanho do bundle, testar desempenho
Etapa 4: Verificar Padrões de Qualidade
Verifique em relação aos requisitos:
- Desempenho: ≥60fps (Chrome DevTools → aba Performance)
- Estabilidade de Layout: CLS = 0 (auditoria Lighthouse)
- Acessibilidade: Respeita prefers-reduced-motion (teste de configurações do sistema)
- Navegação por Teclado: Todos os elementos interativos acessíveis por teclado
- Responsivo Móvel: Gestos amigáveis ao toque, testado em iOS/Android
Árvore de Decisão de Padrões de Animação
INPUT: O que deve animar?
├─ ENTRADA (carregamento de página, montagem)
│ → Padrão: initial={{opacity: 0, y: 20}} animate={{opacity: 1, y: 0}}
│ → Temporização: 0.6-0.8s, ease: [0.22, 1, 0.36, 1]
│ → Stagger: 0.1-0.2s entre elementos
│ → Exemplo: ./examples/hero-fade-up.md
│
├─ GESTO (hover, tap, drag)
│ → Padrão: whileHover={{scale: 1.05}}, whileTap={{scale: 0.95}}
│ → Física: Spring (stiffness: 300-400, damping: 20)
│ → Temporização: Resposta instantânea (sem duração)
│ → Exemplos: ./examples/card-hover.md, ./examples/magnetic-button.md
│
├─ SCROLL (revelação, parallax)
│ → Padrão: whileInView + viewport OU useScroll + useTransform
│ → Gatilho: viewport={{once: true, amount: 0.3}}
│ → Desempenho: Apenas transform/opacity
│ → Exemplos: ./examples/scroll-reveal.md, ./examples/parallax-layers.md
│
└─ LAYOUT (reordenação, expansão)
→ Padrão: propriedade layout (FLIP automático)
→ Compartilhado: layoutId="id" para morfing
→ Ressonância: Anima apenas transformações
Referência Rápida da API
| Componente/Hook | Uso | Quando |
|---|---|---|
| motion.div | <motion.div animate={{x: 100}}> | Animações básicas |
| whileHover | whileHover={{scale: 1.05}} | Estados de hover (0.2-0.3s) |
| whileTap | whileTap={{scale: 0.95}} | Feedback de clique |
| whileInView | whileInView={{opacity: 1}} | Revelação em scroll |
| drag | drag="x" dragConstraints | Elementos arrastáveis |
| layout | <motion.div layout /> | Animação FLIP automática |
| useScroll | Rastrear progresso do scroll | Parallax, barras de progresso |
| useTransform | Mapear valores | Efeitos vinculados ao scroll |
| useSpring | Física spring | Mudanças suaves de valor |
| useInView | Detecção de viewport | Gatilho de animações |
API Completa: Veja Referência Completa da API
Integração com Frameworks
| Framework | Import | Componentes | Animações de Saída |
|---|---|---|---|
| React/Next.js | "motion/react" | <motion.div> | <AnimatePresence> |
| Svelte | "motion" | API vanilla | N/A |
| Astro | "motion" | Scripts do cliente | N/A |
| Vue | "motion-v" | <motion.div> | Similar ao React |
Padrões de Qualidade
| Categoria | Requisito | Como Verificar |
|---|---|---|
| Desempenho | ≥60fps | Chrome DevTools → Performance |
| Aceleração GPU | apenas transform/opacity | Sem width/height/left/top |
| Bundle | <50KB | webpack-bundle-analyzer |
| Acessibilidade | prefers-reduced-motion | Teste de configurações do sistema |
| Móvel | Amigável ao toque | Testes em iOS/Android |
| Mudança de layout | CLS = 0 | Auditoria Lighthouse |
Biblioteca de Exemplos (Carregamento Progressivo)
Carregue sob demanda com base no tipo de animação:
Seções de Herói
- Fade Up de Herói - Entrada clássica estilo Apple
- Stagger de Herói - Elementos orquestrados
- Texto Dividido de Herói - Revelação de caracteres
Efeitos de Scroll
- Revelação em Scroll - Fade-in com Intersection Observer
- Camadas Parallax - Profundidade em múltiplas velocidades
- Progresso de Scroll - Indicador de leitura
Gestos e Interações
- Hover em Card - Elevação elegante + sombra
- Botão Magnético - Segue o cursor
- Carrossel de Arrasto - Slider sensível ao toque
Animações de Layout
- Reordenar Lista - FLIP com arrasto
- Acordeão - Expandir/recolher
- Troca de Aba - Layout compartilhado
Exemplos completos: Todos os arquivos no diretório ./examples/
Documentação de Referência (Carregar Sob Demanda)
- Referência Completa da API - Todos os componentes, hooks, props
- Guia de Física Spring - Ajuste de stiffness, damping, mass
- Otimização de Desempenho - GPU, will-change, carregamento preguiçoso
- Guia de Acessibilidade - Movimento reduzido, teclado, leitores de tela
- Solução de Problemas - Problemas comuns, soluções
- Migração do Framer Motion - Guia de upgrade
Templates (Prontos para Produção)
- Template para Página Next.js - Herói + funcionalidades + depoimentos
- Biblioteca de Componentes - Mais de 10 componentes reutilizáveis
- Template de Scroll - Padrões parallax + revelação
- Template de Dashboard - Cards interativos, gráficos
Instalação
# React/Next.js/Svelte/Astro
npm install motion
# Vue
npm install motion-v
Padrões Comuns (Prontos para Copiar e Colar)
Padrão 1: Fade Up de Entrada
<motion.div
initial={{ opacity: 0, y: 20 }}
animate={{ opacity: 1, y: 0 }}
transition={{ duration: 0.6, ease: [0.22, 1, 0.36, 1] }}
/>
Padrão 2: Hover em Card
<motion.div
whileHover={{ y: -8, boxShadow: "0 20px 40px rgba(0,0,0,0.12)" }}
transition={{ type: "spring", stiffness: 300, damping: 20 }}
/>
Padrão 3: Revelação em Scroll
<motion.div
initial={{ opacity: 0, y: 50 }}
whileInView={{ opacity: 1, y: 0 }}
viewport={{ once: true, amount: 0.3 }}
/>
Mais padrões: Listas com stagger, animações de saída, transições de layout → diretório ./examples/
Tratamento de Erros
| Problema | Solução |
|---|---|
| A animação não dispara | Verifique se os valores de initial ≠ animate |
| Desempenho ruim | Use apenas transform/opacity + CSS will-change |
| Mudança de layout | Defina dimensões explícitas, use a propriedade layout |
| Saída não funciona | Envolva com <AnimatePresence>, adicione a propriedade key |
Melhores Práticas de Implementação
- Comece simples → Construa a partir de fade + slide, adicione complexidade incrementalmente
- Extraia variantes → Defina estados de animação como variantes nomeadas para manutenibilidade
- Prefira física spring → Use transições spring por padrão (mais naturais que tween)
- Stagger em listas → Use staggerChildren (0.1-0.2s) para ritmo e hierarquia
- Teste em dispositivos móveis → Verifique gestos de toque, desempenho em dispositivos iOS/Android
- Inclua movimento reduzido → Sempre forneça animações alternativas para prefers-reduced-motion
- Profile o desempenho → Use a aba Performance do Chrome DevTools, alvo ≥60fps
Filosofia de Design (Princípios Apple/Jon Ive)
Aplique estes princípios de design a todas as animações:
- Simplicidade: Use durações de 200-400 ms, minimize movimentos simultâneos, prefira propriedades de transformação
- Física Natural: Implemente transições baseadas em spring, evite easing linear, aplique movimento baseado em massa
- Movimento Proposital: Guie a atenção do usuário, forneça feedback de interação, estabeleça hierarquia visual
- Restrição Elegante: Aplique o princípio "menos é mais", mantenha temporização consistente, respeite as preferências de movimento do usuário
Validação
Para validação de saída estruturada, veja:
- Esquema de Configuração Motion - JSON schema
- Script de Validação - Verificações automatizadas
Metadados
Versão: 3.0.0 (Otimização Baseada em Pesquisa) Otimização: Linguagem imperativa, padrões few-shot (3 exemplos), complexidade em camadas, carregamento progressivo Eficiência de Tokens: Redução de 87% no núcleo (15K → 2K) + cache automático Motion.dev: v11+ Frameworks: React 19+, Next.js 15+, Svelte 5+, Astro 4+, Vue 3+ Pesquisa: arXiv 2402.07927v1, 2211.01910, 2310.14735v5, PubMed 40334089 Licença: MIT