Marcus Andrey Estudo
Read in English Biblioteca

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

TokenDuraçãoCurvaUse paraCom movimento reduzido
motion.feedback150 ms standardHover, cor, fades pequenosIgual (não há movimento)
motion.press100 ms standardPressionar: um botão cedendo sob o dedoSem escala
motion.enter250 ms enterMenus, popovers, uma página entrandoSó fade, 150 ms
motion.exit150 ms exitAs mesmas coisas saindoSó fade, 150 ms
motion.enter-large350 ms enterPainéis, gavetas, diálogos entrandoSó fade, 150 ms
motion.exit-large250 ms exitAs mesmas coisas saindoSó fade, 150 ms
Uma ficha de tokens preenchida: seis tokens de movimento semânticos, cada um com a sua duração, a sua curva, o seu trabalho e a sua alternativa para movimento reduzido. O que entra desacelera, o que sai acelera e é mais rápido, e nada passa de 350 ms.Valores: Marcus Andrey, CC BY 4.0. Curvas do Material Design 3: standard (0.2, 0, 0, 1), standard decelerate (0, 0, 0, 1), standard accelerate (0.3, 0, 1, 1).

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

Salvo só neste dispositivo.

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