Motion UI
Um playbook fundamentado em pesquisa para movimento e gestos em UI de produto: 19 arquivos de padrões, cada um com regras, antipadrões, referências boas e ruins, acessibilidade, tokens, um esboço de implementação e um checklist. Este arquivo fornece o fluxo de trabalho, os non-negotiables, as tabelas de decisão e os valores padrão de tokens. Abra os arquivos de padrão para aprofundamento.
- Índice de padrões:
references/INDEX.mdlista todos os padrões com sua regra em uma linha. - Arquivos de padrão:
references/patterns/<prefixo>-<nome>.md. Os prefixos sãomfound(propósito, temporização, coreografia, movimento reduzido),mspring(molas),mgesture(arrasto, momentum, bordas, painéis, interrupção),mtrans(entrada/saída, origem espacial, transições de rota, micro-interações, impulsionado por rolagem),mperf(desempenho) emref(rúbrica de revisão, antipadrões). - Tokens iniciais:
assets/motion-tokens.css. Nomes e valores de duração, suavização e espaçamento correspondem aotokens.cssdo dashboard-ui. Funciona sozinho em claro e escuro: os tokens de papel do dashboard-ui que ele lê são declarados com especificidade zero, então otokens.cssdo dashboard-ui ou os tokens do próprio projeto nos mesmos nomes de papel os sobrescrevem em qualquer ordem de carregamento. - UIs de dados: para interpolação de números, transições de gráfico, exploração vinculada, recálculo ao vivo e estados de carregamento, use os padrões
motion-*eprog-*do dashboard-ui. Este skill não os repete.
Fluxo de trabalho
- Decida se deve se mover. Nomeie o trabalho: feedback, continuidade, orientação, atenção ou (raramente) deleite. Estime com que frequência ocorre e se é acionado pelo teclado; então escolha a linha na tabela de frequência abaixo (
mfound-purpose-and-frequency.md). Se não houver trabalho, ou a ação for acionada pelo teclado ou ocorrer 100+ vezes ao dia, pare: sem animação. - Escolha o mecanismo.
- De repouso a repouso e alternado (menus, diálogos, alternâncias): uma transição CSS (
mfound-durations-and-easing.md), ou um tokenlinear()de mola (mspring-css-linear-and-tokens.md). - Acionado por um dedo ou ponteiro, ou interrompível com velocidade: uma mola JS (
mspring-parameters-and-mapping.md,mgesture-interruptibility-and-velocity.md). - Navegação: View Transitions (
mtrans-view-transitions-and-routes.md). - Vinculado à posição de rolagem: animação impulsionada por rolagem (
mtrans-scroll-driven-animations.md).
- De repouso a repouso e alternado (menus, diálogos, alternâncias): uma transição CSS (
- Defina a temporização a partir de tokens. Duração por elemento, suavização por direção, saídas em 0,75× da entrada e molas como duração + bounce. Nunca use valores brutos em componentes.
- Posicione no espaço. Use
transform-originno gatilho, espelhe saídas, mantenha a consistência de ida e volta e deixe o chrome persistente parado (mtrans-spatial-origin-and-continuity.md). Para entrada/saída de elementos de camada superior, sigamtrans-enter-exit-top-layer.md. - Para gestos, aplique em ordem:
- Rastreamento 1:1 com um limiar de 10 px (
mgesture-direct-manipulation-drag.md); - projeção e velocidade ao soltar (
mgesture-momentum-projection-and-snap.md); - bordas com efeito elástico (
mgesture-rubber-banding-and-bounds.md); - as regras de painéis e deslizar para dispensar (
mgesture-sheets-and-swipe-to-dismiss.md).
- Rastreamento 1:1 com um limiar de 10 px (
- Coreografe quando várias coisas mudam: causa primeiro, depois pai, depois filhos; espaçamento de 20–40 ms, com limite (
mfound-choreography-and-stagger.md). - Torne barato. Anime apenas transform e opacidade, não use
will-changeglobal e pinte o feedback no próximo frame (mperf-compositor-will-change-and-inp.md). - Escreva a versão de movimento reduzido como substituições, não remoções (
mfound-reduced-motion-vestibular.md). - Revise a partir de quadros.
- Execute a passagem de antipadrões (
mref-anti-patterns-gallery.md). - Capture tiras de quadros (desacelerado 4×, movimento completo e reduzido, mais uma execução interrompida) e a auditoria na página.
- Pontue a rúbrica de 18 verificações (
mref-motion-review-rubric.md). Envie com 80% ou mais e nenhum "deve verificar" com 0. - Relate cada descoberta como ID da verificação · evidência · correção, mais o que você não verificou.
- Execute a passagem de antipadrões (
Non-negotiables
Quebre um destes apenas com uma justificativa por escrito.
Se e por quanto tempo
- Toda animação tem um trabalho nomeado. Ações acionadas pelo teclado e ações 100+/dia não têm animação.
- A primeira resposta visual chega em até 100 ms da entrada, independentemente da duração da animação.
- As durações vêm de tokens (100 / 150 / 240 / 400 ms). Nada no chrome da UI passa de 400 ms; apenas momentos raros podem chegar a 600 ms.
- Entradas suavizam para fora; movimentos na tela suavizam entrada-saída; nenhum
ease-inem nada que o usuário espera. Saídas têm cerca de 0,75× da entrada.
Molas e gestos
- Molas são escritas como duração + bounce. Use bounce 0 para chrome da UI, 0,1–0,2 apenas após um gesto com momentum, e nunca em opacidade, cor ou valores de dados.
- Elementos arrastados rastreiam o ponteiro 1:1 a partir do ponto de agarre, sem transição durante o arrasto. Comprometa-se com um arrasto após cerca de 10 px.
- Ao soltar, encaixe no alvo mais próximo da posição projetada e inicie a mola de estabilização na velocidade de liberação.
- Bordas têm efeito elástico; nada para bruscamente sob o dedo.
- Tudo que o usuário pode afetar é interrompível a partir de seu valor atual na tela. Não há filas de animação e nenhuma entrada é bloqueada durante o movimento. UI alternada usa transições, não keyframes.
- Ações de gesto destrutivas são confirmadas ao soltar e oferecem desfazer. Todo gesto tem um botão ou equivalente de teclado (WCAG 2.5.7).
Entrada, saída e navegação
- Nunca comece de
scale(0). Entre de opacidade 0 mais escala 0,95–0,97 ou 8–24 px de deslocamento, comtransform-originno gatilho. - Use
@starting-stylepara entrada edisplay/overlaycomallow-discretepara saída. O estado final visível é o padrão, para que navegadores não compatíveis ainda funcionem. - Transições de rota são melhoria progressiva. Prepare os dados primeiro, depois faça a transição. Use o cross-fade padrão ou um deslocamento direcional de 16–24 px por tipo de transição, nomeie 1–3 elementos compartilhados e mova o foco depois.
- Toasts nunca seguram a única cópia da informação. Erros nunca desaparecem automaticamente; um Toast de desfazer fica pelo menos 8 s e sua ação também existe fora do toast. Temporizadores pausam ao passar o mouse, focar e em abas ocultas (dashboard-ui
comp-notifications-alerts.md).
Desempenho e segurança
- Anime apenas propriedades da família transform e opacidade em qualquer coisa maior que um controle pequeno. Sem
transition: all.will-changeé temporário e só segue uma medição. - Sob
prefers-reduced-motion: reduce, substitua o movimento espacial por um fade de 150 ms ou menos, mantenha feedback, mantenha rastreamento de arrasto 1:1 e remova bounce. Nunca envie um kill switch global de0.01ms, e animações JS também devem respeitar a configuração. - Sem paralaxe, sequestro de rolagem, zoom em tela cheia ou animação em loop ociosa na UI do produto. Reprodução automática acima de 5 s tem um controle de pausa, e nada pisca mais de 3 vezes por segundo.
- Revise o movimento a partir de quadros capturados, não do código ou da memória.
Tabelas de decisão
Frequência → movimento (mfound-purpose-and-frequency.md)
| Com que frequência | Movimento |
|---|---|
| Acionado pelo teclado, ou 100+ vezes ao dia (ponto de corte do skill) | Nenhum |
| Dezenas de vezes ao dia | 100–150 ms fade, talvez uma escala pequena; sem movimento, sem bounce |
| Algumas vezes por sessão | 150–240 ms, pode mover 8–24 px |
| Raro (primeira execução, grande sucesso) | Até 400–600 ms, uma mola com bounce permitido |
Mecanismo (mspring-parameters-and-mapping.md, mspring-css-linear-and-tokens.md)
| Situação | Use |
|---|---|
| Cor, opacidade, mudança de estado | Transição CSS, linear ou ease-out |
| Elemento alternado que pode ser revertido no meio do caminho | Transição CSS (nunca keyframes) |
| Movimento espacial de repouso a repouso com sensação de mola | Token CSS linear() de mola com sua própria duração |
| Liberação após arrasto ou lançamento, ou redirecionamento com velocidade | Mola JS (Motion, React Spring, SwiftUI, Compose) |
| Mudança de layout (reordenar, redimensionar, expandir) | FLIP, Motion layout ou uma View Transition |
| Mudança de página ou rota | View Transition (mesmo ou entre documentos) |
| Progresso através de um rolador | Animação impulsionada por rolagem |
Duração e suavização por elemento (mfound-durations-and-easing.md)
| Elemento | Duração | Curva |
|---|---|---|
| Pressionamento, alternância, hover | 100 ms | ease-out (pressionar escala 0,97) |
| Tooltip, menu, popover | 150 ms in / 110 ms out | ease-out in, ease-in ou fade out |
| Diálogo, toast | 240 ms in / 180 ms out | ease-out in, ease-in ou fade out |
| Painel, gaveta | 240–400 ms | --motion-ease-drawer, ou uma mola após arrasto |
| Transformação de contêiner (cartão → detalhe) | 400 ms | enfatizada |
| Cross-fade de rota | 150–250 ms | linear |
Predefinições de mola (mspring-parameters-and-mapping.md)
| Token | Duração / bounce | Uso |
|---|---|---|
spring-fast | 0,24 s / 0 | alternâncias, controles pequenos |
spring-default | 0,3 s / 0 | menus, estabilização de painel, layout |
spring-slow | 0,45 s / 0 | superfícies de tela cheia |
spring-snappy | 0,3 s / 0,15 | liberação após um toque, encaixes |
spring-playful | 0,4 s / 0,3 | deleite raro apenas |
Parâmetros de bibliotecas (Motion, React Spring, SwiftUI, Material 3) vêm de uma fórmula em mspring-parameters-and-mapping.md.
Limiares de gesto (mgesture-*)
| Valor | Padrão |
|---|---|
| Início de arrasto / trava de eixo | 10 px |
| Janela de amostragem de velocidade | 100 ms |
| Desaceleração de projeção | 0,998 por ms (0,99 para paginação rápida) |
| Toque confirma | > 400 px/s |
| Fechamento de painel | > 25% de sua altura arrastada, ou um toque |
| Constante de efeito elástico | 0,55 (a aproximação comum) |
Valores padrão de token
Conjunto completo em assets/motion-tokens.css.
| Grupo | Padrões |
|---|---|
| Duração | instant 0 · micro 100 · short 150 · medium 240 · long 400 ms · proporção de saída 0,75 |
| Suavização | standard cubic-bezier(0.2,0,0.38,0.9) · enter (0,0,0.38,0.9) · exit (0.2,0,1,0.9) · emphasized (0.2,0,0,1) · drawer (0.32,0.72,0,1) |
| Molas (CSS) | --motion-spring-{fast,default,slow,snappy,playful} com -dur correspondente (360 / 450 / 670 / 420 / 660 ms) |
| Geometria | escala-de 0,96 · pressionar 0,97 · distância 8 / 16 / 24 px |
| Coreografia | espaçamento 30 ms · máximo 300 ms (150 ms em menus) |
| Movimento reduzido | tokens espaciais colapsam para 0 ou 1; fades mantêm sua temporização |
Como aplicar este skill
- Ao construir:
- Carregue
assets/motion-tokens.css, ou mapeie-o nos tokens do projeto. - Prefira recursos da plataforma: transições CSS,
@starting-style,<dialog>e a API popover, View Transitions, animações impulsionadas por rolagem,linear(). Recorra a uma biblioteca JS apenas para gestos e velocidade. - Nunca use o tipo TypeScript
any.
- Carregue
- Ao revisar: capture quadros primeiro, depois execute a galeria de antipadrões e a rúbrica. Relate uma tabela de verificação, pontuação, evidência e correção, ordenada por severidade, e liste o que você não verificou.
- Quando o projeto tem um sistema de movimento (M3, Carbon, seus próprios tokens): os tokens do projeto vencem. Mapeie-os nestes papéis e sinalize as lacunas.
- Quando as regras conflitam: acessibilidade e controle do usuário (movimento reduzido, interrompibilidade, sem sequestro de rolagem) vencem a expressividade, e frequência vence o deleite.