Antheo Motion
Movimento é informação sobre mudança: algo chegou, saiu, moveu-se ou respondeu a você. Movimento que não explica nada é ruído; uma mudança sem movimento é um salto. Este skill decide quais mudanças se movem e dá a cada uma seu tempo exato. O momento de assinatura de um componente pertence ao antheo-moment; os tokens de duração são gerados pelo antheo-tokens; o requisito de movimento reduzido é verificado pelo antheo-access. Auditar, cortar ou planejar o movimento em toda uma aplicação é tarefa do antheo-motion-audit.
Decida nesta ordem
- Liste cada mudança que a tela sofre: o que abre, fecha, aparece, some, reordena, atualiza, carrega, tem sucesso ou falha.
- Marque com que frequência uma pessoa vê cada uma: muitas vezes ao dia, diariamente ou raramente.
- Dê a cada uma sua duração e suavização a partir das tabelas abaixo.
- Entregue o evento raro e significativo, se houver, ao antheo-moment.
- Verifique rápido, duas vezes e com movimento reduzido, depois filme e leia os quadros (abaixo).
Nomeie por que se move, ou não mova
"Isso se move para que a pessoa entenda ___." Não consegue completar a frase: sem animação.
Quanto mais frequente, menos se move
| Com que frequência | Recebe |
|---|---|
| Muitas vezes ao dia (digitação, linhas, abas, menus, uma paleta) | no máximo 150ms, 4px de deslocamento; pelo teclado, apenas um fade curto |
| Diariamente (um diálogo, um painel, um toast, um salvamento) | uma chegada curta e uma saída mais rápida, 150 a 300ms |
| Raramente (um primeiro sucesso, um pedido feito) | o único lugar para um momento de assinatura (antheo-moment) |
As durações, por função
| Token | Valor | Leva |
|---|---|---|
--dur-instant | 100ms | feedback de cor e opacidade |
--dur-fast | 150ms | pressionamento, hover (entrada e saída), abertura de menu ou tooltip |
--dur-base | 200ms | saída de coisas, fechamento de diálogo, troca de valor ou texto, chegada de toast |
--dur-open | 250ms | abertura de diálogo, abas, acordeão, redimensionamento de cartão |
--dur-slow | 300ms | painel ou gaveta subindo, marcador deslizando |
--dur-page | 400ms | transição de página ou elemento compartilhado |
Animações de interface ficam em ou abaixo de 300ms; movimentos de página em ou abaixo de 400ms. Spinners, progresso e movimento vinculado a rolagem usam linear.
Abertura e fechamento, em pares
| Coisa | Abre | Fecha |
|---|---|---|
| Menu, popover, select | 150ms, a partir de scale(0.97) e um fade, no gatilho | 120ms |
| Tooltip | 400ms de atraso, depois um fade de 150ms; imediatamente se dentro de 300ms de outra que fechou | Imediatamente |
| Diálogo | 250ms: subida de 8px, fade, escala a partir de 0.96 | 200ms |
| Painel, gaveta | 300ms a partir de sua borda, totalmente opaco durante todo o percurso (sem fade, sem blur) | 200ms |
| Toast | 200ms, subida de 12px | 200ms, saindo pelo mesmo caminho que veio |
| Acordeão, revelação de altura | 250ms, grid-template-rows: 0fr para 1fr | 200ms |
Nunca atrase um fechamento ou um hover-out: encurte a duração.
Uma única curva para chegar e sair
--ease-out cubic-bezier(0.23, 1, 0.32, 1) para tudo que entra ou sai. --ease-in-out cubic-bezier(0.77, 0, 0.175, 1) apenas para algo que se move de um lugar a outro na tela. --ease-in apenas para algo descartado permanentemente. Saídas são mais rápidas que entradas e percorrem cerca de metade da distância.
Pequenas distâncias, nunca partindo de zero
Desloque 4px para troca de valor ou popover, 8px para diálogo, 12px para toast, 24px para um elemento herói; a borda completa apenas para um painel. Entre a partir de scale(0.96) (0.97 para menus, 0.98 para tooltips) com opacidade 0, nunca a partir de scale(0). Blur de 4px em troca de texto ou ícone, 8px em superfície grande, 2px em crossfade abaixo de 200ms.
O que pode animar
transform e opacity (e cor) por padrão; um breve blur de filter, clip-path e grid-template-rows para revelações de altura quando necessário. Nunca transition: all, nunca width, height, top, left ou margin, nunca box-shadow em si: coloque uma sombra variável em um pseudo-elemento e desbote-a. will-change apenas após um perfil pedir.
Cresça a partir do gatilho
Menus e popovers tomam seu transform-origin no gatilho (Radix expõe --radix-popover-content-transform-origin); um modal permanece centralizado; um painel vem da borda em que vive; um elemento compartilhado (um cartão abrindo em sua página) usa um único view-transition-name em cada lado.
Transições para estado, keyframes para eventos únicos
Qualquer coisa que uma pessoa possa alternar usa uma transição CSS ou uma mola, que revertem no meio do caminho; keyframes apenas para coisas que tocam uma vez.
Stagger de 30 a 40ms, os primeiros oito, 300ms no total
60 a 80ms para as três a seis partes de um herói. Nunca use stagger em algo aberto com frequência, e nunca bloqueie um clique enquanto os itens chegam.
Molas apenas onde uma mão as move
Um botão de alternância, um arrasto solto, uma pílula segmentada deslizante. Ressalto de 0 a 0.2 em controles (o overshoot fica dentro da trilha), até 0.45 para uma celebração rara; no máximo uma oscilação. Um arrasto segue o dedo sem transição e, ao soltar, usa mola a partir da velocidade de soltura; um painel fecha com um flick mais rápido que cerca de 0.11px por ms, ou após percorrer min(64px, 15%) de sua altura, caso contrário retorna com mola (references/gestures.md).
Nada pula
Cada valor que muda é visto mudar; uma linha removida fecha seu espaço; o espaço é reservado para o que aparece (deslocamento de layout abaixo de 0.1). Ao carregar, no máximo uma entrada. Alterne temas com transições desligadas por um quadro.
Movimento reduzido mantém a história em fades
Com prefers-reduced-motion: reduce, deslocamento, escala, blur, parallax e saltos tornam-se um crossfade de opacidade de 150 a 200ms; um botão de alternância move-se imediatamente; loops automáticos param. Qualquer coisa que se mova por mais de 5 segundos sozinha tem um controle de pausa (WCAG 2.2.2); nada pisca mais de 3 vezes por segundo (2.3.1).
Em toda a aplicação
- Encontre: uma tabela de cada mudança, com que frequência é vista, como se move agora, como deveria.
- Melhore: tokens para cada número, as saídas faltantes, origem no gatilho, um padrão de cada vez.
- Remova: qualquer coisa que anime a cada carregamento, toque em uma ação de muitas vezes ao dia, atrase a próxima ação, loope enquanto as pessoas leem, ou ultrapasse 300ms em uma ação rotineira. Quando em dúvida, remova.
- Aprove ou bloqueie: uma frase de motivo, apenas tokens, apenas as propriedades permitidas, uma saída mais rápida que a entrada, movimento reduzido tratado, assistido em velocidade normal e com desaceleração de CPU 4×.
Verifique
Clique em tudo rápido, duas vezes: reverte, nunca pula. Abra o menu vinte vezes: ainda rápido. Force a CPU 4×: ainda suave. Ative movimento reduzido: nada se desloca.
Assista: uma imagem estática não julga movimento
Uma captura de tela do estado final não diz nada sobre como uma coisa se move, e todo verificador lê quadros estáticos. Então filme cada movimento que fez e olhe os quadros antes de considerar concluído:
node <antheo-motion>/scripts/filmstrip.mjs <url> --clip ".tuner" --click ".preset" --duration 600
node <antheo-motion>/scripts/filmstrip.mjs <url> --clip ".sheet" --drag ".handle" --by 0,240 --duration 900
Isso desacelera a página para 0.1× (CSS, Web Animations e o relógio JavaScript), faz a única ação e dispõe 12 quadros do elemento em uma folha, cada um com seu tempo. Abra a folha e leia cada quadro:
- cada quadro parece composto por si só: nenhuma borda dura deslizando, nenhum flash de cor errada, nenhuma caixa vazia
- cada valor que muda é visto mudar: um número que deveria rolar não pula enquanto sua agulha ainda viaja
- nada reflui ou pula no meio do caminho; o primeiro quadro já responde ao pressionamento
- o final se estabelece onde deveria: uma mola overshota um pouco e volta, um controle não para de repente
- filme novamente com
--reducee--dark: a história ainda é contada, e o escuro não tem flash de luz
Corrija o que um quadro mostra, filme novamente e mantenha a última folha como evidência.
O que a UI gerada erra aqui
Verifique cada item em references/habits.md antes de considerar concluído: transition: all · conteúdo oculto até um script revelá-lo · um reset genérico de movimento reduzido · um anel de foco que desbota ou desliza · movimento que performa · efeitos hover em coisas que não são clicáveis · uma transição lendo um nome que ninguém definiu.
Quando mais movimento é correto
As regras de propósito e frequência decidem; os números são padrões. Um jogo, uma ferramenta criativa, um produto de aprendizado ou um momento de marca que a pessoa pediu podem se mover mais e por mais tempo. Ainda assim responde à entrada imediatamente, nunca bloqueia a próxima ação, pode ser interrompido no meio do caminho, respeita movimento reduzido e mostra seu custo: um quadro lento em um telefone de gama média é uma descoberta, independentemente do estilo.
Concluído
- Cada mudança listada com sua frequência de visualização; as frequentes mal se movem; ações de teclado não viajam
- Durações e suavização a partir dos tokens; os pares de abertura e fechamento acima; sem fechamentos atrasados
- Apenas as propriedades permitidas; origem no gatilho; nada a partir de scale(0)
- Movimento reduzido torna-se um crossfade; loops acima de 5s podem pausar
- Clicado rápido duas vezes, com desaceleração 4× e com movimento reduzido
- Cada movimento filmado (
scripts/filmstrip.mjs), cada quadro lido, claro, escuro e reduzido - Verificado contra cada hábito em
references/habits.md
Arquivos
scripts/filmstrip.mjs: filma um movimento a 0.1× em uma folha de quadros, com o tempo abaixo de cada umreferences/recipes.md: o índice de 36 receitas prontas para copiar, um arquivo cada emreferences/recipes/, desde pressionamento e popover até rolagem de números e texto em streamingreferences/why.md: a razão por trás de cada regra, para quando um valor parecer arbitrário ou alguém quiser quebrá-lareferences/gestures.md: arrasto, deslize, painéis, pontos de encaixe, momentum, elasticidade (sensação de telefone: antheo-mobile)references/choreography.md: várias coisas como uma única mudança: fechamento de lacunas, reordenações, redimensionamento de painéis, crossfadesreferences/springs.md: molas em palavras simples, predefinições, uma mola JS de 30 linhas,linear()com fallbacksreferences/performance.md: o que é barato de animar, 60fps em um telefone barato, como perfilharreferences/advanced.md: 3D, animação orientada por rolagem, View Transitions, filmagem de movimentoreferences/vocabulary.md: descrições simples para nomes de padrões para receitasreferences/motion-kit.css: a cópia fallback domotion.cssgeradoreferences/habits.md: o que a UI gerada erra aqui, cada um com sua correção