Marcus Andrey Estudo
Read in English Biblioteca

Design systems · Laboratórios · 6 min de leitura

Desenhe um componente com variantes no Figma

Um laboratório guiado: desenhe o botão do Harbour como um conjunto de componentes no Figma, começando pela API. Escreva a tabela de propriedades, monte uma base com auto layout e variáveis, acrescente propriedades de variante, booleana, de troca de instância e de texto, e teste o componente do jeito que as pessoas vão quebrá-lo. Cerca de duas horas no Figma.

Um conjunto de componentes com 90 variantes costuma ser três propriedades fingindo ser uma só. O caminho mais rápido para um componente pequeno e honesto é escrever a API antes de desenhar: que escolhas um designer faz, e o que é só conteúdo? Você vai montar o botão do Harbour desse jeito, para que as propriedades no Figma batam com as props do código e o conjunto continue pequeno.

O que você vai fazer:

  • Escrever a tabela de propriedades do botão antes de desenhar
  • Montar uma base com auto layout e variáveis semânticas
  • Acrescentar propriedades de variante, depois booleana, de troca de instância e de texto
  • Decidir o que é variante, o que é propriedade e o que é slot
  • Testar o componente com texto longo, nos dois modos e com uma troca

Você vai precisar de: Figma (publicar numa biblioteca pede um plano pago; montar, não), as variáveis de Monte um conjunto de tokens com modos ou qualquer conjunto claro e escuro, cerca de duas horas.


1. Escreva a API primeiro

variant
size
booleana
Reservar lugar

Button: variant=primarysecondarydanger, size=mdsm, showIcon=truefalse, label="Reservar lugar"

O botão do Harbour com as propriedades que você vai construir: duas propriedades de variante, uma booleana e uma de texto. Três variantes vezes dois tamanhos dão seis variantes no Figma; o ícone e o rótulo são propriedades, não variantes, então não multiplicam o conjunto. Contraste do texto: 6,35:1 (primary, secondary) e 5,14:1 (danger).Demo ao vivo: Marcus Andrey, CC BY 4.0. Só CSS, sem script.

Brinque com a figura: esse é o componente que você vai montar. Antes de abrir o Figma, escreva a tabela de propriedades. O Figma tem cinco tipos de propriedade de componente: variant, boolean, instance swap, text e slot (Figma, Explore component properties).

Propriedade Tipo no Figma Valores Padrão No código
variant Variant primary, secondary, danger primary variant
size Variant md, sm md size
state Variant default, hover, pressed, focus, disabled default estados de CSS, não uma prop
label Text qualquer "Button" children
showIcon Boolean true, false false icon está definido
icon Instance swap qualquer ícone do Harbour Icons arrow-right icon

A regra prática: se muda a aparência do componente por uma escolha de design, é variante. Se é conteúdo, é texto ou troca de instância. Se liga ou desliga uma parte, é booleana. Um rótulo como variante, ou um ícone por variante, é o que faz os conjuntos explodirem.

O state é variante no Figma porque designers precisam mostrar hover e foco e passá-los no handoff, mas no código esse trabalho é do navegador (:hover, :focus-visible, disabled). Anote isso na coluna "No código", para ninguém criar uma prop state (veja Estados e casos-limite).


2. Monte uma base

  1. Desenhe o botão primary, médio, uma vez: um frame com auto layout, horizontal, gap 8, padding space.5 (24 px) à esquerda e à direita, altura 44.
  2. Dentro dele, uma camada de texto para o rótulo e uma instância de ícone depois dela.
  3. Ligue o preenchimento a color.action.primary, o texto a color.text.on-action e o raio do canto a radius.control. Nenhum hex solto.
  4. Configure o frame para hug no eixo horizontal, para que um rótulo longo faça o botão crescer em vez de ser cortado.
  5. Transforme em componente (⌥⌘K no Mac, Ctrl+Alt+K no Windows) e dê o nome Button.

Confira a base nos dois modos antes de multiplicá-la. Cada erro agora vira 30 erros depois.


3. Acrescente as propriedades de variante

Acrescente uma propriedade Variant no painel de propriedades; o Figma transforma o componente num component set, um contêiner que só pode ter componentes. Cada variante precisa ser uma combinação única de valores, mas você não precisa construir todas as combinações (Figma, Create and use variants).

  1. Chame a primeira propriedade de variant e acrescente secondary e danger. Troque as ligações: secondary tem preenchimento color.surface.default com contorno de 2 px e texto em color.action.primary; danger usa color.feedback.danger.
  2. Acrescente size, com sm: padding 16, altura 32, rótulo de 14 px.
  3. Acrescente state por último, com os cinco valores. O foco é um anel de 2 px com 2 px de afastamento, numa cor que passa 3:1 contra o fundo nos dois modos.

Três variantes × dois tamanhos × cinco estados dão 30 componentes. Tudo bem; 30 numa grade clara são fáceis de manter. Organize-os em grade com rótulos ao lado do conjunto, e deixe o padrão (primary, md, default) no canto superior esquerdo, porque o Figma usa a variante do canto superior esquerdo como padrão.


4. Acrescente as outras propriedades

  • Propriedade de texto na camada do rótulo, com o nome label. Agora designers digitam o rótulo no painel de propriedades sem cavar nas camadas.
  • Booleana na camada do ícone, com o nome showIcon, desligada por padrão.
  • Troca de instância no ícone, com o nome icon, com instâncias preferidas definidas como uma lista curta de ícones que fazem sentido num botão.

Use a edição múltipla para aplicar tudo a todas as variantes de uma vez. Depois abra o painel de propriedades numa instância: você deve ver variant, size, state, label, showIcon e icon, e nada mais. Se aparecer "Property 2", renomeie.


5. Variante, propriedade ou slot?

O botão não precisa de slot. Um slot é uma área flexível num componente onde as pessoas podem acrescentar e organizar conteúdo numa instância sem desvinculá-la, útil para coisas como uma lista de tarefas ou o corpo de um card ou de um diálogo (Figma, Slots).

Experimente num segundo componente para sentir a diferença: um SailingCard do Harbour, com cabeçalho e corpo. Transforme o corpo num slot, com instâncias preferidas (Tag, Notice, um bloco de texto) e no máximo três camadas. Agora um card só comporta o que os times de produto precisam, sem uma variante para cada combinação, que é a ideia de Composição em vez de configuração.


6. Teste do jeito que as pessoas vão quebrar

  1. Rótulo longo: "Continuar para o pagamento e a escolha do lugar". Ele cresce, quebra a linha ou corta? Decida e documente.
  2. Rótulo curto: "OK". Ainda tem pelo menos 24 × 24 px? (A WCAG 2.2 pede 24 × 24 pixels CSS como tamanho mínimo de alvo, Understanding 2.5.8.)
  3. Modo escuro: troque o modo de variáveis no frame. Toda variante, todo estado.
  4. Troca: coloque uma instância e mude variant, size e icon. Nada deve se mexer sem você esperar.
  5. Um designer que não montou o componente: entregue o componente e uma tela para fazer. Observe onde a pessoa hesita.

7. Confira seu trabalho

Perguntas para refletir: Que propriedade você quis transformar em variante, e por que ela não era? Qual foi o primeiro erro do designer que não montou o componente?

Relacionadas

Variantes, propriedades e slots · Anatomia e API de um componente · Montar uma biblioteca no Figma · Code Connect e a ponte entre design e código · Componentes acessíveis

Salvo só neste dispositivo.

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