Marcus Andrey Estudo
Read in English Biblioteca

Motion e interação · Passo 7 · 8 min de leitura

Tokens de movimento

Uma duração digitada à mão é uma decisão que ninguém encontra de novo. Como transformar durações e curvas num conjunto pequeno de tokens com nome, em três camadas, no formato da comunidade do W3C e em CSS, com o movimento reduzido já embutido.

Uma bandeja de tokens de movimento: três durações em forma de barras, com o comprimento de cada uma igual ao seu tempo, e uma peça de easing com a curva em relevo. Aponte para um token e ele sai da bandeja, pronto para uso; os vizinhos sobem um pouco. Este passo é isso: num sistema de movimento, os times escolhem num pequeno conjunto de valores com nome em vez de inventar um número novo em cada tela. Este passo tem três lições: tokens de movimento, o que as diretrizes públicas de movimento ensinam, e documentar o movimento num design system.Ilustração: Marcus Andrey, desenhada com Hairline (MIT, Lucas Marques).

Um token de movimento é uma decisão com nome, para a próxima pessoa não ter de tomá-la de novo. Abra o código de qualquer produto e procure por ms. Você vai achar 180, 200, 220, 250 e 300, muitas vezes para o mesmo tipo de coisa, cada um digitado por alguém que chutou de boa-fé. Cor e espaçamento viraram tokens há anos. Movimento é o mesmo problema, e a solução é a mesma: poucos valores com nome, escolhidos uma vez, usados em todo lugar.

O que você vai conseguir fazer depois de ler:

  • Explicar por que durações e curvas devem virar tokens
  • Organizar tokens de movimento em três camadas: primitiva, semântica, de componente
  • Escrevê-los no formato da comunidade do W3C e em CSS
  • Embutir a versão de movimento reduzido nos tokens, e não em cada componente

1. Por que o movimento precisa de tokens

Mesma distância, mesma curva (standard), quatro durações
  • motion.duration.100100 ms · press
  • motion.duration.150150 ms · feedback
  • motion.duration.250250 ms · enter
  • motion.duration.350350 ms · enter-large

O seu sistema pede movimento reduzido, então os pontos pulam em vez de deslizar. É esse o comportamento que um token de movimento reduzido deve dar.

A escala de duração, tocada. Mesma distância e mesma curva, então a única diferença é o tempo: 100 ms parece instantâneo, 350 ms parece viagem. Mudanças pequenas ficam na ponta curta, superfícies grandes na ponta longa. Marque de novo para trazê-los de volta.CSS ao vivo: uma transition por linha, transform: translateX(). Marcus Andrey, CC BY 4.0.

Tudo neste curso até aqui foi um valor: uma duração de Duração: quanto tempo é o certo, uma curva de Curvas de easing, uma alternativa de Desenhar uma versão com movimento reduzido. Valores digitados à mão se desencontram. Dois menus abrem em 200 e 250 ms, um painel fecha mais devagar do que abre, e ninguém decidiu nada disso.

Tokens resolvem três coisas de uma vez:

  • Consistência. O mesmo trabalho se move do mesmo jeito em todo lugar, então as pessoas aprendem uma vez só.
  • Mudança. Se 250 ms parecer lento depois do teste, você muda um valor, não quarenta arquivos.
  • Conversa. "Use motion.enter" é uma frase que design e desenvolvimento entendem igual. "Deixa mais ágil" não é.

A figura toca uma escala de duração pequena. Quatro degraus bastam para a maioria dos produtos: um para pressionar, um para feedback, um para o que entra, um para superfícies grandes.


2. Três camadas

  1. 1Primitivo

    Valores crus, com o nome do que são.

    • motion.duration.100 100 ms
    • motion.duration.150 150 ms
    • motion.duration.250 250 ms
    • motion.duration.350 350 ms
    • motion.easing.standard 0.2, 0, 0, 1
    • motion.easing.enter 0, 0, 0, 1
    • motion.easing.exit 0.3, 0, 1, 1
  2. 2Semântico

    Uma duração e uma curva, com o nome do trabalho.

    • motion.press 100 + standard
    • motion.feedback 150 + standard
    • motion.enter 250 + enter
    • motion.exit 150 + exit
    • motion.enter-large 350 + enter
    • motion.exit-large 250 + exit
  3. 3Componente

    Onde cada trabalho é usado.

    • button.press → press
    • button.hover → feedback
    • menu.open → enter
    • menu.close → exit
    • sheet.open → enter-large
    • sheet.close → exit-large
Três camadas de tokens de movimento: quem desenha escolhe na do meio. Os primitivos guardam os números, os semânticos juntam uma duração e uma curva para um trabalho, e os componentes apontam para o trabalho. Mude motion.enter uma vez e todo menu e toda página que entram mudam junto.Diagrama: Marcus Andrey, CC BY 4.0. Curvas do Material Design 3 (standard, standard decelerate, standard accelerate).

Tokens de movimento funcionam melhor nas mesmas camadas dos tokens de cor (veja O que é um design system):

Camada Guarda Nome pelo Exemplo
Primitiva Um valor cru Que ele é motion.duration.250 = 250 ms
Semântica Uma duração e uma curva juntas Trabalho motion.enter = 250 ms + curva de entrada
Componente Um ponteiro para um token semântico Lugar onde é usado menu.open → motion.enter

Design e desenvolvimento escolhem na camada semântica. Os primitivos são a paleta; ninguém deveria digitar motion.duration.250 num componente, porque isso diz quanto tempo, não por quê.

Duas regras tornam a camada semântica útil:

  • Junte duração e curva. Uma duração sozinha convida a curva errada. "Enter" quer dizer 250 ms e desacelerar.
  • Saídas são mais curtas que entradas. As pessoas esperam pelo que está chegando, não pelo que está saindo. O Atlassian escreve isso como regra: comece o movimento na hora e faça as saídas mais rápidas que as entradas (Atlassian Design System, Motion).

As curvas deste kit são a standard, a standard decelerate e a standard accelerate do Material Design 3: cubic-bezier(0.2, 0, 0, 1), (0, 0, 0, 1) e (0.3, 0, 1, 1) (Material Components, Motion). Pegar curvas publicadas emprestadas não tem problema; a próxima aula mostra o que cada sistema escolheu.


3. Tokens no formato da comunidade do W3C

O formato do Design Tokens Community Group é o formato de arquivo comum que a maioria das ferramentas de tokens lê. A primeira versão estável, 2025.10, define um tipo duration, um tipo cubicBezier e um tipo transition, que junta duração, atraso e curva (DTCG, Design Tokens Format Module 2025.10). É um relatório de Community Group, não um padrão do W3C, mas é para onde as ferramentas estão convergindo.

{
  "motion": {
    "duration": {
      "250": { "$type": "duration", "$value": { "value": 250, "unit": "ms" } }
    },
    "easing": {
      "enter": { "$type": "cubicBezier", "$value": [0, 0, 0, 1] }
    },
    "enter": {
      "$type": "transition",
      "$value": {
        "duration": "{motion.duration.250}",
        "delay": { "value": 0, "unit": "ms" },
        "timingFunction": "{motion.easing.enter}"
      }
    }
  }
}

Três detalhes da especificação que vale conhecer:

  • Uma duração é um objeto com um número e uma unidade, ms ou s, e não um texto como "250ms".
  • Uma Bézier cúbica são quatro números. Os dois valores de x precisam ficar entre 0 e 1; os de y podem sair desse intervalo, e é assim que se escrevem curvas que passam do ponto.
  • Chaves são referências: "{motion.duration.250}" aponta para o primitivo, então o token semântico muda quando o primitivo muda.

O formato não tem tipo para molas. Se você usa molas (veja Molas e física), guarde os parâmetros como números e documente. O Material faz exatamente isso no Android: cada token de mola é uma razão de amortecimento e uma rigidez, como 0,9 e 1400 para movimentos pequenos e rápidos (Material Components, Motion).


4. Tokens em CSS

Na web, os tokens costumam chegar como custom properties. Este é o kit que o botão de Anime os estados de um botão usa, exatamente como está no CSS deste site:

.mo-d-kit {
  --motion-duration-feedback: 150ms;
  --motion-duration-press: 100ms;
  --motion-easing-standard: cubic-bezier(0.2, 0, 0, 1);
}

E a figura da seção 1 é uma regra só. Cada linha define --d como a duração de um token e --e como a curva:

.mo-d-lane__run { display: block; width: 100%; height: 100%; transition: transform var(--d) var(--e); }
.mo-d-play:has(.mo-d-go:checked) .mo-d-lane__run { transform: translateX(calc(100% - 1.5rem)); }
@media (prefers-reduced-motion: reduce) { .mo-d-lane__run { transition: none; } }

5. O movimento reduzido mora nos tokens

Se cada componente escreve a sua própria regra de movimento reduzido, alguns vão esquecer. Ponha a decisão na camada semântica: cada token tem um valor normal e um reduzido.

Uma divisão útil vem dos tokens de mola do Material, que são de dois tipos: spatial, para posição e tamanho, e effects, para opacidade e cor, que não devem passar do ponto (Material Components, Motion). A mesma linha serve para o movimento reduzido: com prefers-reduced-motion: reduce, o movimento espacial sai e os efeitos ficam. Um painel para de deslizar e passa a aparecer num fade; um hover continua mudando de cor. Isso bate com a WCAG, cuja definição de animação de movimento deixa de fora mudanças de cor e de opacidade que não mudam tamanho, forma ou posição (W3C, Understanding 2.3.3).

Na prática, um token reduzido costuma bastar: um fade de 150 ms. Todo token semântico que move alguma coisa cai nele.


6. Erros comuns

  • Tokens com nome de valor na camada semântica: motion.fast não diz a ninguém para que serve.
  • Um token de duração sem curva ao lado, então cada time escolhe a sua.
  • Dez durações "por garantia". Se duas estão a 20 ms uma da outra, ninguém vê a diferença; junte as duas.
  • Saídas tão longas quanto entradas.
  • Movimento reduzido resolvido componente por componente, e faltando em metade deles.
  • Tokens no Figma e no código com valores diferentes.

7. Vocabulário

Termo Significado
Token de movimento Uma duração, curva ou combinação com nome, usada no lugar de um valor cru
Token primitivo Um valor cru com o nome do que ele é: motion.duration.250
Token semântico Um token com o nome do seu trabalho: motion.enter
Token de componente O ponteiro de um componente para um token semântico: menu.open
Referência Um token cujo valor aponta para outro: "{motion.duration.250}"
DTCG O Design Tokens Community Group e o seu formato comum de arquivo de tokens

8. Experimente (sem ferramentas)

  1. Liste cinco coisas que se movem num produto que você usa todo dia: um menu, um painel, um toast, um botão sendo pressionado, uma troca de página.
  2. Dê a cada uma um nome de trabalho: entrar, sair, feedback, pressionar.
  3. Com quantos trabalhos diferentes você terminou? Essa é, mais ou menos, a sua camada semântica.

Perguntas para refletir: Quais duas animações do seu produto fazem o mesmo trabalho mas se movem de jeitos diferentes? Qual você mudaria para combinar com a outra, e por quê?


9. Se você já pratica

  • Procure ms e cubic-bezier no código. Agrupe o que achar por trabalho; essa é a sua primeira lista de tokens, e o seu plano de migração.
  • Mantenha a camada semântica pequena, de cinco a oito tokens, e só acrescente quando um pedido não couber em nenhum que já existe.
  • Exporte os tokens de uma fonte só para as variáveis do Figma e para o CSS, para eles não se desencontrarem.
  • Escreva o valor reduzido ao lado do normal no arquivo de tokens, e não num documento separado.

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

O que as diretrizes públicas de movimento ensinam · Escreva um conjunto de tokens de movimento · Duração: quanto tempo é o certo · Curvas de easing · Molas e física · O que é um design system · Escala de durações

Salvo só neste dispositivo.

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