Padrões de Movimento de UI
Duas tarefas: animar uma interface de produto real na web e recriar a interface de produto para vídeo sem redesenhar. Ambas usam os mesmos tokens.
1. Tokens primeiro
Defina o movimento uma vez e importe-o em todos os lugares. Sem números inline nos componentes.
// lib/motion-tokens.ts
export const motionTokens = {
duration: { instant: 0.1, fast: 0.18, normal: 0.3, slow: 0.5, scene: 0.7 },
easing: {
standard: [0.2, 0, 0, 1], // entrada + movimento
exit: [0.4, 0, 1, 1], // saída
emphasized: [0.3, 0, 0, 1],
},
distance: { nudge: 4, small: 8, medium: 16, large: 32 },
stagger: 0.06, // mantenha entre 0.05 e 0.10
} as const;
export const springs = {
press: { type: "spring", stiffness: 600, damping: 38 }, // botões, toggles
snappy: { type: "spring", stiffness: 420, damping: 34 }, // chips, menus
gentle: { type: "spring", stiffness: 260, damping: 27 }, // cards, painéis
layout: { type: "spring", stiffness: 320, damping: 30 }, // reordenar, redimensionar
camera: { type: "spring", stiffness: 140, damping: 20 }, // movimentos grandes, apenas vídeo
} as const;
Com massa 1, taxa de amortecimento ζ = damping / (2·√stiffness): press 0.78, snappy 0.83, gentle 0.84, layout 0.84, camera 0.85 — todas dentro da faixa 0.75–0.90 (overshoot ≤ ~6 %). Ajuste por marca com essa fórmula e mantenha esta tabela como fonte única.
2. Acessibilidade e SSR
"use client";
import { useReducedMotion } from "motion/react";
export function useSafeMotion() {
const reduce = useReducedMotion();
return {
reduce,
// movimento reduzido: remova transforms, mantenha mudanças curtas de opacity (≤0.2 s)
enter: reduce ? { opacity: 1 } : { opacity: 1, y: 0 },
initial: reduce ? { opacity: 0 } : { opacity: 0, y: 8 },
transition: reduce ? { duration: 0.2 } : undefined,
};
}
- Use
initial={false}para elementos já visíveis na primeira pintura para evitar flashes de hidratação. - Anime apenas
transformeopacity. Nunca animewidth,height,top,leftoubox-shadowem loops; uselayoutou scale. - Dispositivos de baixo desempenho: encurte durações e pule movimento decorativo.
3. Padrões e suas regras
| Padrão | Regra |
|---|---|
| Pressão de botão | whileTap={{ scale: 0.96 }} com springs.press; feedback em até 100 ms |
| Renderização condicional | envolva em AnimatePresence com uma key estável; todo initial + animate tem um exit |
| Transição de página / rota | AnimatePresence mode="wait": saída termina antes da entrada |
| Stagger de lista | staggerChildren 0.05–0.10 s; limite itens com stagger a ~8, o resto aparece junto |
| Reordenar / redimensionar | layout em subárvores pequenas (≲5 filhos); caso contrário, x/y explícito |
| Modal / sheet | foco preso, Escape fecha, bloqueio de rolagem, role="dialog", aria-modal="true", retorno de foco |
| Toast | entra pela borda onde vive; auto-dispensa pausa ao passar o mouse/foco |
| Mudança de número | rolagem vertical: valor antigo sai para cima com desfoque, novo entra de baixo; font-variant-numeric: tabular-nums |
| Revelação por scroll | whileInView com viewport={{ once: true }}; nunca re-animar ao rolar para fora |
| Carregamento → sucesso | botão comprime → spinner → check; mantenha a largura do botão estável |
4. Reconstruindo a UI do produto para vídeo
- Meça, não adivinhe. Pegue tokens do source do produto ou estilos computados: cores, raios, família/pesos/tracking da fonte, espaçamento, conjunto de ícones e traço. Amostre cores de screenshots reais e compare.
- Padrão híbrido. Screenshot real como contexto; reconstrua apenas os elementos que animam, alinhados pixel a pixel sobre ele.
- Nunca redesenhe sem aprovação explícita. Sem novas cores, fontes, ícones ou texto.
- Capture limpo. Logado com conta de demonstração ou deslogado, dados fictícios, sem PII, sem marcas de terceiros a menos que o usuário as possua.
- Buscável. Em vídeo, direcione cada valor animado a partir do tempo absoluto (
value = f(t)), não do estado de runtime domotion/react. Usemotion/reactpara a web ao vivo, molas de forma fechada ou timelines GSAP para vídeo renderizado.
Quando esses padrões são usados em um site em vez de um vídeo, execute a verificação de aprovação
design-expert (teclado, foco, movimento reduzido, desempenho) antes de publicar.