Marcus Andrey Estudo
Read in English Biblioteca

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
Teste o padrão

O seu sistema pede movimento reduzido, então você está vendo a alternativa: um fade de 150 ms.

Um padrão de movimento documentado num cartão só: por que se move, o que dispara, quais tokens, o que acontece com movimento reduzido e quem é o dono. A demonstração ao lado roda os mesmos valores.Exemplo de especificação e CSS ao vivo: Marcus Andrey, CC BY 4.0.

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:

  1. 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.
  2. Tokens. As durações e curvas de Tokens de movimento, cada uma com o seu trabalho e o seu valor reduzido.
  3. Padrões. Os cartões: entrar e sair, expandir e recolher, transições de página, feedback.
  4. Acessibilidade. Como o movimento reduzido funciona no sistema todo, com os critérios da WCAG que ele atende (veja WCAG e movimento).
  5. 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 com motion.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:

  1. A tabela de tokens, com os valores reduzidos.
  2. 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.
  3. 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)

  1. Escolha uma coisa que se move no seu produto.
  2. Preencha no papel o cartão da seção 1, campo por campo.
  3. 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

Livros, cursos e vídeos para ir mais fundo

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

Salvo só neste dispositivo.

↑ ↓ para mover · Enter para abrir · Esc para fechar