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
Button: variant=primarysecondarydanger, size=mdsm, showIcon=truefalse, label="Reservar lugar"
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
- 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. - Dentro dele, uma camada de texto para o rótulo e uma instância de ícone depois dela.
- Ligue o preenchimento a
color.action.primary, o texto acolor.text.on-actione o raio do canto aradius.control. Nenhum hex solto. - 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.
- 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).
- Chame a primeira propriedade de
variante acrescentesecondaryedanger. Troque as ligações: secondary tem preenchimentocolor.surface.defaultcom contorno de 2 px e texto emcolor.action.primary; danger usacolor.feedback.danger. - Acrescente
size, comsm: padding 16, altura 32, rótulo de 14 px. - Acrescente
statepor ú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
- Rótulo longo: "Continuar para o pagamento e a escolha do lugar". Ele cresce, quebra a linha ou corta? Decida e documente.
- 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.)
- Modo escuro: troque o modo de variáveis no frame. Toda variante, todo estado.
- Troca: coloque uma instância e mude
variant,sizeeicon. Nada deve se mexer sem você esperar. - 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