Motion e interação · Passo 7 · 7 min de leitura
Documentar o movimento num design system
O movimento é a parte de um design system mais difícil de pôr no papel, porque uma página parada não consegue mostrá-lo. O que uma seção de movimento contém, como documentar um padrão num cartão, por que toda especificação precisa de uma demonstração ao vivo e de uma linha sobre movimento reduzido, e como começar pequeno.
Movimento que não está escrito é refeito de memória, um pouco diferente a cada vez. Os tokens dão os valores. A documentação dá às pessoas os motivos, os padrões e os limites, para que quem chegar no mês que vem faça a mesma escolha que você faria. E como o movimento acontece no tempo, a documentação também precisa se mexer.
O que você vai conseguir fazer depois de ler:
- Planejar a seção de movimento de um design system
- Documentar um padrão de movimento num cartão
- Decidir onde o movimento mora: numa seção própria, nas páginas dos componentes ou nas duas
- Começar com uma primeira versão e melhorá-la com o uso
1. Um padrão, um cartão
Bottom sheet: abrir e fechar
- Propósito
- Mostrar que o painel vem de baixo e volta para lá, para a pessoa saber que a página continua por baixo.
- Gatilho
- Toque em "Filtros". Fecha no botão de fechar, num toque no scrim ou com Esc.
- O que se move
- O painel sobe (
transform); o scrim aparece (opacity). Nada mais. - Abrir
motion.enter-large: 350 ms,cubic-bezier(0, 0, 0, 1)- Fechar
motion.exit-large: 250 ms,cubic-bezier(0.3, 0, 1, 1). Saídas são mais rápidas.- Movimento reduzido
- Sem deslizar. Painel e scrim aparecem e somem num fade de 150 ms,
motion.easing.standard. - Não faça
- Fazer o painel quicar, ou animar a altura dele.
- Dono · mudança
- Time do design system · v2.3, fechar encurtado de 350 ms
O seu sistema pede movimento reduzido, então você está vendo a alternativa: um fade de 150 ms.
A unidade básica da documentação de movimento é um padrão: uma coisa que se move, por um motivo. O cartão da figura responde às perguntas que design, desenvolvimento e revisão vão fazer, na ordem em que fazem. A demonstração ao lado usa os mesmos tokens, então a página não consegue se desencontrar do código.
Todo cartão de padrão de movimento tem os mesmos campos:
| Campo | O que responde |
|---|---|
| Propósito | Por que se move. O que as pessoas perderiam sem isso |
| Gatilho | O que começa, e o que termina ou reverte |
| O que se move | As propriedades, de preferência só transform e opacity (veja Performance do movimento) |
| Tokens | O token semântico de cada sentido, nunca valores crus |
| Movimento reduzido | O que acontece no lugar (veja Desenhar uma versão com movimento reduzido) |
| Não faça | O erro que as pessoas sempre cometem com ele |
| Demonstração | A coisa de verdade, rodando |
| Dono e changelog | Para quem perguntar, e o que mudou quando |
2. O que a seção de movimento contém
O conselho de Val Head para design systems é um bom roteiro. Comece conversando com quem vai usar: onde a animação atrapalha, como fazem o handoff hoje, o que gostariam de ter. Depois escreva os princípios, defina durações e curvas, e acrescente tokens, código e demonstrações (Val Head, Including Animation In Your Design System, Smashing Magazine, 2019).
Uma seção de movimento costuma ter cinco partes:
- Princípios. Três ou quatro frases curtas sobre por que o seu produto se move, como o "funcional, natural, consistente, atraente" do Fluent (Fluent 2, Motion). Elas dão a quem revisa algo melhor que o gosto para argumentar.
- Tokens. As durações e curvas de Tokens de movimento, cada uma com o seu trabalho e o seu valor reduzido.
- Padrões. Os cartões: entrar e sair, expandir e recolher, transições de página, feedback.
- Acessibilidade. Como o movimento reduzido funciona no sistema todo, com os critérios da WCAG que ele atende (veja WCAG e movimento).
- Desempenho. Quais propriedades são permitidas, e como conferir (veja Performance do movimento).
3. Mostre, não descreva
Uma curva numa página é o desenho de um número. As pessoas precisam vê-la rodar. Val Head diz sem rodeios: nunca subestime o poder de mostrar em vez de contar.
- Demonstrações ao vivo na documentação, feitas com os tokens de verdade, para mudarem quando os tokens mudarem.
- Um vídeo curto ou um GIF onde código ao vivo não for possível, com os nomes dos tokens.
- Um "faça" e um "não faça", lado a lado, tocando ao mesmo tempo.
- Uma chave de movimento reduzido em cada demonstração, ou instruções para ligar a configuração do sistema, para quem lê ver as duas versões.
4. Onde o movimento mora
Em dois lugares, e a maioria dos bons sistemas usa os dois:
- Uma seção de movimento para princípios, tokens e padrões que atravessam componentes: transições de página, coreografia.
- Uma linha de movimento em cada página de componente: "Menu: abre com
motion.enter, fecha commotion.exit, faz fade com movimento reduzido." É ali que as pessoas realmente olham.
Mantenha pequena a lista de padrões com nome. Cada um é uma coisa que você precisa manter, demonstrar e testar em toda plataforma, um ponto que Val Head também levanta.
5. Comece pequeno, publique, melhore
Não espere uma linguagem de movimento completa. O conselho de Head é trabalhar por etapas em vez de esperar as diretrizes de movimento ficarem perfeitas. Uma primeira versão que já ajuda:
- A tabela de tokens, com os valores reduzidos.
- Três cartões de padrão para o movimento que o seu produto mais usa: em geral um menu, um painel ou diálogo, e o feedback de botão.
- Um parágrafo sobre movimento reduzido.
Depois revise após um mês de uso real: quais perguntas as pessoas ainda fizeram? Esses são os próximos cartões.
6. Erros comuns
- Princípios sem tokens, ou tokens sem princípios.
- Durações escritas na documentação diferentes das do código.
- Capturas de tela paradas de um movimento, sem demonstração.
- Nenhum campo de movimento reduzido, então cada time inventa a sua alternativa.
- Movimento documentado só numa seção separada, que ninguém abre a partir da página do componente.
- Esperar ficar completo, e nunca publicar.
7. Vocabulário
| Termo | Significado |
|---|---|
| Padrão de movimento | Um movimento recorrente com um propósito, documentado à parte |
| Cartão de padrão | A página ou o bloco que especifica um padrão |
| Princípios de movimento | Frases curtas sobre por que e como o produto se move |
| Demonstração ao vivo | O padrão rodando na documentação, feito com os tokens de verdade |
| Changelog | Uma lista datada do que mudou no sistema e por quê |
8. Experimente (sem ferramentas)
- Escolha uma coisa que se move no seu produto.
- Preencha no papel o cartão da seção 1, campo por campo.
- Qual campo foi mais difícil de preencher? Essa é a decisão que ninguém tomou.
Perguntas para refletir: Onde uma pessoa nova no seu time procuraria primeiro orientações de movimento, na seção de movimento ou na página do componente? O que tem lá hoje?
9. Se você já pratica
- Gere as tabelas de tokens da documentação a partir do arquivo de tokens, para elas nunca ficarem velhas.
- Torne obrigatório o campo de movimento reduzido no modelo de padrão.
- Ligue cada cartão de padrão ao código, e o código de cada componente de volta ao cartão.
- Pergunte à engenharia quais dúvidas de movimento aparecem mais; escreva esses cartões primeiro.
Checklist
Para saber mais
- Val Head, Including Animation In Your Design System (Smashing Magazine, 2019)
- IBM Carbon, Motion · Microsoft Fluent 2, Motion · Atlassian Design System, Motion: três seções de movimento publicadas para comparar
- DTCG, Design Tokens Format Module 2025.10
Livros, cursos e vídeos para ir mais fundo
- Designing Interface AnimationVal HeadLivro · Rosenfeld Media, 2016 (Amazon)
- Design SystemsAlla KholmatovaLivro · Smashing Magazine, 2017 (Amazon)
Os links dos livros são de afiliado da Amazon: como associado, recebo por compras qualificadas, sem custo a mais para você.
Relacionadas
Tokens de movimento · O que as diretrizes públicas de movimento ensinam · Movimento na governança do design system · Lottie, Rive e a entrega do movimento · O que é um design system · Handoff para desenvolvedores · Ficha de especificação de movimento