Motion e interação · Laboratórios · 4 min de leitura
Escreva um conjunto de tokens de movimento
Um laboratório guiado: reúna todas as durações e curvas que um produto usa, agrupe por trabalho, reduza a uma escala pequena, dê nome aos tokens semânticos, acrescente valores para movimento reduzido e escreva o conjunto no formato DTCG e em CSS. Cerca de duas horas, com um código ou um conjunto de telas e uma planilha.
A maioria dos produtos já tem tokens de movimento. Eles só estão escondidos em quarenta arquivos, com quarenta valores ligeiramente diferentes. Você vai encontrá-los, agrupá-los pelo que fazem e reduzi-los a um conjunto pequeno o bastante para caber na memória. O resultado é uma tabela e um arquivo que design e desenvolvimento conseguem usar amanhã.
O que você vai fazer:
- Reunir as durações e curvas que um produto usa hoje
- Agrupar por trabalho e escolher uma escala pequena
- Dar nome aos tokens semânticos e um valor para movimento reduzido a cada um
- Escrever o conjunto no formato DTCG e como custom properties de CSS
Você vai precisar de: acesso a um código (ou, se não tiver, dez telas de um produto que você possa gravar), uma planilha, um editor de texto, cerca de duas horas.
1. Reúna o que existe
Procure no código por ms, s;, cubic-bezier, ease e transition. Sem código? Grave dez interações de um app e estime cada uma contando os quadros numa gravação de tela.
Ponha cada uma numa linha: onde (componente), o que se move, duração, curva. Espere surpresas: a maioria dos times encontra de seis a doze durações para três ou quatro trabalhos.
2. Agrupe por trabalho
Acrescente uma coluna, trabalho, e use só estas palavras: press, feedback, enter, exit, e enter-large e exit-large para painéis, gavetas e diálogos. Se algo não couber, pergunte se aquilo deveria se mover (veja Quando não animar).
Depois ordene por trabalho. Cada grupo com mais de uma duração é uma decisão que ninguém tomou.
3. Escolha a escala
Para cada grupo, escolha uma duração. Use as orientações de O que as diretrizes públicas de movimento ensinam:
- Feedback frequente fica abaixo de 150 ms (Atlassian, Motion).
- Maior e mais longe leva mais tempo, mas as transições ficam em torno de 400 ms ou menos.
- Saídas são mais curtas que entradas.
- Junte valores a menos de 50 ms um do outro. As pessoas não vão sentir a diferença; você ainda vai ter de mantê-la.
Você deve terminar com quatro a seis durações primitivas. Escolha três curvas: standard, enter (desacelerar), exit (acelerar). Pegue-as emprestadas de um sistema público e anote de qual.
4. Dê nome aos tokens semânticos
| Token | Duração | Curva | Use para | Com movimento reduzido |
|---|---|---|---|---|
motion.feedback | 150 ms | standard | Hover, cor, fades pequenos | Igual (não há movimento) |
motion.press | 100 ms | standard | Pressionar: um botão cedendo sob o dedo | Sem escala |
motion.enter | 250 ms | enter | Menus, popovers, uma página entrando | Só fade, 150 ms |
motion.exit | 150 ms | exit | As mesmas coisas saindo | Só fade, 150 ms |
motion.enter-large | 350 ms | enter | Painéis, gavetas, diálogos entrando | Só fade, 150 ms |
motion.exit-large | 250 ms | exit | As mesmas coisas saindo | Só fade, 150 ms |
Agora preencha a ficha: uma linha por trabalho, com a duração, a curva, para que usar e o que acontece com movimento reduzido. A figura é uma ficha pronta, o mesmo conjunto usado em Tokens de movimento e nos laboratórios anteriores.
A coluna de movimento reduzido é a mais importante. Use a regra de Desenhar uma versão com movimento reduzido: o deslocamento sai, fades e cor ficam. Uma alternativa só, um fade de 150 ms, cobre a maioria das linhas.
5. Escreva o arquivo
Escreva o conjunto no formato do Design Tokens Community Group, para qualquer ferramenta de tokens conseguir ler (DTCG, Format Module 2025.10). Primeiro os primitivos, depois os tokens semânticos que fazem referência a eles:
{
"motion": {
"duration": {
"100": { "$type": "duration", "$value": { "value": 100, "unit": "ms" } },
"150": { "$type": "duration", "$value": { "value": 150, "unit": "ms" } },
"250": { "$type": "duration", "$value": { "value": 250, "unit": "ms" } },
"350": { "$type": "duration", "$value": { "value": 350, "unit": "ms" } }
},
"easing": {
"standard": { "$type": "cubicBezier", "$value": [0.2, 0, 0, 1] },
"enter": { "$type": "cubicBezier", "$value": [0, 0, 0, 1] },
"exit": { "$type": "cubicBezier", "$value": [0.3, 0, 1, 1] }
},
"enter": {
"$type": "transition",
"$description": "Menus, popovers, a page coming in. Reduced motion: fade only, 150 ms.",
"$value": {
"duration": "{motion.duration.250}",
"delay": { "value": 0, "unit": "ms" },
"timingFunction": "{motion.easing.enter}"
}
}
}
}
Acrescente os outros cinco tokens semânticos do mesmo jeito. Ponha o trabalho e a regra de movimento reduzido em $description, que o formato permite em qualquer token, para o motivo viajar junto com o valor. Escreva a descrição na língua do seu time.
Depois o CSS que os seus componentes vão ler:
:root {
--motion-duration-press: 100ms;
--motion-duration-feedback: 150ms;
--motion-duration-enter: 250ms;
--motion-duration-exit: 150ms;
--motion-duration-enter-large: 350ms;
--motion-duration-exit-large: 250ms;
--motion-easing-standard: cubic-bezier(0.2, 0, 0, 1);
--motion-easing-enter: cubic-bezier(0, 0, 0, 1);
--motion-easing-exit: cubic-bezier(0.3, 0, 1, 1);
}
6. Teste em três animações de verdade
Escolha três animações do seu inventário, uma por trabalho, e refaça-as só com os tokens. Se alguma ficar errada, decida o que está errado: o token ou a animação. Mude um dos dois e anote por quê.
Mostre o resultado a uma pessoa de design e a uma de desenvolvimento. Pergunte a cada uma: "Qual token você usaria para uma tooltip?" Se as duas escolherem o mesmo sem te perguntar, os nomes funcionam.
7. Confira seu trabalho
Perguntas para refletir: Com quantas durações você começou, e quantas sobraram? Qual junção foi mais difícil de combinar?
Relacionadas
Tokens de movimento · O que as diretrizes públicas de movimento ensinam · Documentar o movimento num design system · Duração: quanto tempo é o certo · Curvas de easing