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.
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
motion.duration.100100 ms · pressmotion.duration.150150 ms · feedbackmotion.duration.250250 ms · entermotion.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.
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
- 1Primitivo
Valores crus, com o nome do que são.
motion.duration.100100 msmotion.duration.150150 msmotion.duration.250250 msmotion.duration.350350 msmotion.easing.standard0.2, 0, 0, 1motion.easing.enter0, 0, 0, 1motion.easing.exit0.3, 0, 1, 1
- 2Semântico
Uma duração e uma curva, com o nome do trabalho.
motion.press100 + standardmotion.feedback150 + standardmotion.enter250 + entermotion.exit150 + exitmotion.enter-large350 + entermotion.exit-large250 + exit
- 3Componente
Onde cada trabalho é usado.
button.press→ pressbutton.hover→ feedbackmenu.open→ entermenu.close→ exitsheet.open→ enter-largesheet.close→ exit-large
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,
msous, 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.fastnã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)
- 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.
- Dê a cada uma um nome de trabalho: entrar, sair, feedback, pressionar.
- 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
msecubic-bezierno 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
- DTCG, Design Tokens Format Module 2025.10: os tipos
duration,cubicBezieretransition - Material Components for Android, Motion: tokens de easing, duração e mola, com os valores
- Atlassian Design System, Motion: tokens semânticos de movimento e faixas de duração
- W3C, Understanding SC 2.3.3 Animation from Interactions
- MDN, prefers-reduced-motion
Livros, cursos e vídeos para ir mais fundo
- Designing Interface AnimationVal HeadLivro · Rosenfeld Media, 2016 (Amazon)
- Including Animation In Your Design SystemVal HeadSmashing Magazine, artigo gratuito, em inglês (site externo)
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