O que Seenry Motion faz?
A movimento existe para explicar uma mudança: de onde algo veio, o que a entrada fez, em que estado a interface está agora. Construa cada animação através da sequência abaixo, em ordem; as etapas 1 e 2 decidem se algum código será escrito.
Tome a decisão e declare-a em uma linha; não ofereça um menu de opções de movimento. Estenda os tokens e componentes de movimento existentes do projeto, em vez de adicionar um conjunto paralelo.
A sequência de construção
1. Deve animar? Decida pela frequência.
| Com que frequência as pessoas veem | Decisão |
|---|---|
| 100+ vezes ao dia (menu de comandos, atalhos de teclado, navegação de lista com setas) | Sem animação. Instantâneo. |
| Dezenas de vezes ao dia (hover, abas, alternâncias) | ≤150ms em opacidade e cor apenas, ou nada |
| Ocasionalmente (menus, diálogos, folhas, notificações) | Movimento padrão da tabela abaixo |
| Raramente (onboarding, primeiro sucesso, momentos de vazio para cheio) | Espaço para personalidade |
Ações acionadas por teclado nunca esperam por animação. Se a regra disser não, diga e entregue a mudança de estado instantânea.
2. Nomeie o propósito em uma palavra: feedback, orientação (de onde veio ou para onde foi), estado, continuidade (evitar um salto brusco), explicação (apenas marketing e onboarding) ou deleite (apenas momentos raros). Sem propósito, sem animação. Dados que as pessoas estão lendo nunca se movem por estilo.
3. Escolha a ferramenta mais barata que funciona.
| Necessidade | Ferramenta |
|---|---|
| Hover, pressionamento, cor, alternância de classe ou atributo | CSS transition |
Entrada na montagem, saída antes de display: none, <dialog> e popover nativos | CSS transition + @starting-style + allow-discrete |
Altura para auto | interpolate-size: allow-keywords, ou a trilha de grid 0fr → 1fr |
| Mudanças de rota, lista → detalhe, indicadores de morfismo | View Transitions API |
| Efeitos vinculados à rolagem | animation-timeline: view() / scroll() |
| Programático, cancelável, sem biblioteca | Web Animations (element.animate) |
| Molas com velocidade, animação de layout, gestos, presença em React | Motion (motion.dev) |
| Um componente inteiro (notificação, gaveta, menu de comando, select) | Uma biblioteca mantida, veja libraries |
4. Escolha as propriedades. Apenas translate, scale, rotate, opacity, clip-path, filter. Nunca entre de scale(0): comece em 0.95–0.97 com opacidade 0. Popovers escalonam a partir do seu gatilho (transform-origin no lado do gatilho); diálogos escalonam do centro. Translados percentuais (translate: 0 100%) movem pelo tamanho próprio do elemento.
5. Escolha a curva e duração, ou uma mola.
| Movimento | Duração | Suavização |
|---|---|---|
| Feedback de pressionamento | 100–160ms | --ease-out |
| Tooltip, pequeno popover | 120–200ms | --ease-out |
| Menu, dropdown, select | 150–250ms | --ease-out |
| Diálogo | 200–250ms | --ease-out |
| Folha, gaveta | 350–500ms | --ease-drawer |
| Elemento cruzando a tela, morfismos | 250–400ms | --ease-in-out |
| Cor, fundo, borda em hover | 150ms | ease |
| Progresso, marquee, preenchimento de segurar-para-confirmar | enquanto durar o trabalho | linear |
--ease-out: cubic-bezier(0.23, 1, 0.32, 1), --ease-in-out: cubic-bezier(0.77, 0, 0.175, 1), --ease-drawer: cubic-bezier(0.32, 0.72, 0, 1). Nunca ease-in em movimento de interface: atrasa exatamente o momento que as pessoas estão observando. Prefira UI de produto abaixo de 300ms; viagens mais longas de folha precisam de uma razão. Saídas são muitas vezes ~20–30% mais rápidas que entradas, a menos que preservar uma relação de manipulação direta ou espacial justifique o mesmo tempo. Use uma mola para qualquer coisa que o usuário arraste, lance ou possa reverter no meio do caminho: Motion {type: "spring", duration: 0.5, bounce: 0.2} (bounce 0 para UI de produto, ≤0.3 para lúdico), ou as molas CSS linear() em recipes.
6. Planeje interrupção e saída. Prefira transições CSS para mudanças reversíveis de propriedade, pois elas redirecionam do valor atual. Quando geometria ou coreografia precisar de WAAPI, capture o estado renderizado atual, cancele ou redirecione animações próprias e proteja contra conclusão obsoleta. Uma segunda entrada reverte ou substitui a solicitação antiga, em vez de enfileirar atrás dela. Publique o novo estado lógico imediatamente; um estado de apresentação separado pode manter uma saída pintada.
Refine a mudança interrompida. Use essas verificações onde elas se encaixam no componente. São heurísticas de design, não uma pontuação garantida. Experimente entradas repetidas durante entrada e saída, incluindo com 50–150ms de intervalo; registre temporizações reais ao fazer alegações de tempo.
- Mantenha continuidade e semântica. Abas, filtros ou estados de status relacionados podem compartilhar uma célula de grid (
display:grid,grid-area:1/1) e transitar opacidade ou um pequeno translate. Mantenha conteúdo inativo fora da ordem de foco e da árvore de acessibilidade; montado não significa interativo. Uma fase de saída rápida (aproximadamente 65–90ms) e entrada de 120–160ms podem ser um ponto de partida, não uma receita obrigatória. Desmonte ou esconda apenas quando a transição atual o permitir; uma conclusão obsoleta nunca deve esconder um estado mais novo. WAAPI explicitamente cancelável e saídas de diálogo nativo protegidas são alternativas válidas. - Mantenha o resultado compreensível. Evite intervalos em branco acidentais ou texto concorrente ilegível. Escolha sobreposição, um pequeno crossfade ou uma substituição instantânea com base no conteúdo; um desbotamento de rótulo inteiro pode ser mais seguro do que mover texto através de arte. Preserve uma dica estática apropriada enquanto o movimento estiver indisponível ou reduzido. Inspecione a legibilidade real em vez de usar um limiar de opacidade como prova.
- Uma cópia de uma coisa viajante. Quando um título, avatar ou capa se move para um novo lugar, evite pintura duplicada visível. Esconda o destino até que o viajante aterrisse, então retire a cópia temporária. Trace o texto contra a arte e a casca móvel; um ponto final sem recorte não prova um caminho legível.
- O rótulo concorda com seu resultado. Um rótulo como "Marcar como pago" tornando-se "Pago" segue o mesmo estado de aplicação aceito que seu resultado. Reserve seu espaço quando útil e evite texto obsoleto ou rótulos duplicados focalizáveis. Não atrase um estado de sucesso real apenas para terminar a decoração.
- Sequências podem ser canceladas. Demonstrações de digitação, revelações em etapas e repetições compartilham um proprietário para etapas pendentes. Pausa, reversão e nova entrada cancelam trabalho obsoleto e redirecionam o movimento visível de seu estado atual. Um timeout obsoleto não deve retomar uma sequência pausada ou sobrescrever conteúdo mais novo.
- Libere animações finalizadas. Estabeleça o estado final através de CSS ou estilos confirmados, então libere animações WAAPI finitas próprias quando apropriado.
fill:forwardsnão deve continuar sobrescrevendo mudanças de estado posteriores. Verifique animações inesperadas após a interação se estabelecer, enquanto permite um indicador de carregamento intencional em andamento até seu trabalho terminar. - Cada movimento explica uma relação. Menus crescem a partir de seu gatilho, painéis de sua borda, e conteúdo relacionado move-se consistentemente com a navegação. Use as faixas de duração acima como pontos de partida; mantenha a resposta percebida imediata e justifique viagens mais longas. Teste interrupção e movimento reduzido em vez de tratar uma duração fixa como prova de qualidade.
Alcançando 9. No juiz de movimento, 7 é correto mas genérico, 8 é claramente premium e 9 é distintivo ao nível da Apple ou Linear. Rodadas estagnam em 7–8 pelas mesmas poucas razões. Resolva todas antes de gastar uma rodada:
- Um componente de cada vez. Julgue cada componente sozinho com
--labels "<Linha>"até pontuar 9, e mantenha a melhor versão de cada. Um catálogo geral segue suas linhas mais fracas, então consertar muitas linhas ao mesmo tempo nunca o move, e uma mudança que abaixa uma linha é revertida mesmo quando o juiz a sugeriu. - Aplique cada correção, não apenas a principal. Itens pequenos que recorrem (feedback de hover, pressionamento e fechamento) seguram
statesem 7 rodada após rodada.--prev <last motion.json>lista os critérios que não subiram e as interações pedidas para corrigir novamente;check.mjspassa isso automaticamente. - Um problema que retorna após sua correção é estrutural. Re-temporização não pode consertar um caminho que cruza. Elementos compartilhados mantêm seu arranjo relativo entre estados: um título abaixo de sua capa permanece abaixo dela na visualização de detalhes, então nenhum passa pelo outro.
- Sem quadros vazios. Em cada momento filmado (30–320ms) a região alterada mostra conteúdo real. Uma casca carrega seu conteúdo conforme cresce; uma resposta em streaming cresce a partir de suas primeiras palavras. Nunca mostre uma caixa de resposta em branco ou um esqueleto que espera e depois se dissolve.
- Uma ideia trabalhada por componente. O que persiste viaja e o que é novo nasce de sua causa. Um fade, um translate de 4px e uma troca de rótulo pontuam 7.
- Feche onde abriu. Uma superfície que abre de um controle fecha do mesmo ponto: o controle se torna (ou é substituído no lugar por) seu fechamento, então a mão nunca viaja. Não precisa manter a mesma cor; mantém o lugar e o tamanho.
- Uma única rodada não é uma pontuação. Uma rodada do juiz (ela mesma uma mediana de três) move por um ponto em código inalterado. Aceite um 9 apenas quando duas rodadas separadas ambas o alcançarem, e compare versões no mesmo número de rodadas.
7. Entregue movimento reduzido e bloqueio de entrada com ele. Sob prefers-reduced-motion: reduce, remova movimento, paralaxe, desfoque e loops; mantenha mudanças curtas de opacidade que ajudam na compreensão. Bloqueie movimento em hover com @media (hover: hover) and (pointer: fine). Cada mudança de estado animada também deixa uma dica estática (rótulo, ícone, cor) para quando o movimento não for executado.
Receitas
Comece de recipes para feedback de pressionamento, menus e popovers, tooltips, diálogos, folhas, notificações, acordeões, entradas escalonadas, indicadores de aba, transições de página e elementos compartilhados, revelações de rolagem, trocas de ícone, mudanças numéricas, segurar-para-confirmar, arrastar-para-dispensar (com projeção de velocidade e elasticidade), mascaramento crossfade, troca de tema e supressão de primeira renderização. As receitas CSS nativas são exercitadas no Chromium pelos testes do pacote.
Ativos executáveis
| Mudança solicitada | Rota focada |
|---|---|
| Menu de ação ou rótulo de status curto | Original menu de ação, alternância de status e transições de produto. Se o menu for solicitado a animar aberto e fechado, preserve sua superfície através da fase de fechamento; desmontagem condicional ao fechar pula essa fase. Para uma transição de status, mova o texto em um slot reservado; uma substituição de texto simples ou mudança de cor de ponto sozinha é incompleta. A aplicação possui a ação real. |
| Divulgação em fluxo ou geometria mutável | Original cartão expansível, ajudante de geometria e padrões de superfície. Preserve o foco e redirecione da geometria atual. |
| Tarefa modal focada | Original superfície modal e padrões de superfície. Use um diálogo nativo para comportamento de camada superior e foco; permita que a saída termine antes de fechar, e faça a reversão cancelar o fechamento pendente. |
| Mudança de número ou ícone | Transições de número e adaptadores. Para uma contagem de inteiros pequena, prefira o ajudante de contagem-pop original em vez de reconstruir semântica de dígito. Mantenha um valor acessível real; não esconda cada dígito e coloque aria-label em um <strong> simples. Uma transição de dígito precisa de movimento por lugar; mantenha unidades ancoradas. |
| Entrada ou saída de voz ao vivo | Original presença de voz aceita estado de propriedade da aplicação e um nível de áudio normalizado. Mantenha controles e anúncios no DOM; um sinal de demonstração gerado não é atividade de microfone. |
| Presença de carregamento ou processo | Original campo de sinal, traço de limite e padrões de carregamento. Tempo de animação não é progresso. |
| Imagem decodificada ou material expressivo | Original revelação de imagem, superfícies sólida reflexiva e de borda, inclinação de ponteiro, efeitos de superfície e efeitos expressivos. Mantenha conteúdo útil enquanto uma substituição carrega; use reflexão e inclinação apenas onde o material tem um propósito. |
| Projetar qualquer novo componente interativo (brief, grafo de estado, pontuação de movimento, contrato de entrada, checklist) | Artesanato de interação |
| Pilha de notificações ou banners | Padrões de feedback e original reducer de notificação. Remova overflow do estado ativo antes de sua saída; teste o quarto evento em uma pilha de três itens. |
| Marco ocasional concluído | Original explosão de confirmação. Registre o sucesso no estado da aplicação primeiro, depois toque a decoração finita; o resultado final deve permanecer visível após ela limpar. |
| Abas selecionadas ou mudança de página ordenada | Original superfície de seleção para um destaque compartilhado e estágio direcional para visões relacionadas; a aplicação possui seleção, painéis, rota e histórico. Use padrões de navegação para outras estruturas. |
| Rolagem ou um sistema coordenado | Coreografia de rolagem, pontuações trabalhadas, coreografia de sistema e o índice de movimento. |
Selecione apenas o guia e ajudante necessários para esta mudança. Os ativos originais agrupados são pontos de partida reutilizáveis, não substitutos automáticos para um componente fonte nomeado ou prova de fidelidade a ele. Mantenha licenças com qualquer tempo de execução de terceiros copiado; os ativos Seenry originais usam a licença MIT do repositório.
Nunca envie
| Nunca | Em vez disso |
|---|---|
| Animação em uma ação de 100+/dia ou acionada por teclado | Mudança instantânea |
transition: all | Nomeie propriedades específicas |