Marcus Andrey Estudo
Read in English Biblioteca

Design systems · Passo 3 · 8 min de leitura

Variantes, propriedades e slots

Há três jeitos de um componente cobrir muitos casos: variantes para um conjunto fixo de versões, propriedades para pequenos interruptores, slots para áreas abertas. Quando usar cada um, como eles se multiplicam, e como dar os mesmos nomes no Figma e no código.

Flexibilidade é uma decisão de design, e todo tipo de flexibilidade tem um preço. Um componente que não muda acaba copiado e desvinculado. Um componente que muda tudo deixa de ser sistema. Variantes, propriedades e slots são três respostas diferentes para "o que pode mudar aqui?", e escolher a certa para cada parte é a maior parte do ofício de construir um componente.

O que você vai conseguir fazer depois de ler:

  • Diferenciar uma variante de uma propriedade e de um slot
  • Escolher o tipo certo para cada coisa que muda num componente
  • Estimar quantas combinações as suas escolhas criam, e mantê-las baixas
  • Dar nomes que digam a mesma coisa no Figma e no código

1. Um componente, muitos casos

variant
size
iconStart

<Button variant="primarysecondaryghostdanger" size="defaultcompact" iconStart="ticket">Reservar travessia</Button>

O Button do Harbour como um conjunto de propriedades. Escolha um valor em cada eixo e o mesmo componente muda, junto com a linha de código embaixo dele. Quatro variantes × dois tamanhos × ícone ligado ou desligado = 16 combinações saindo de um componente, não 16 componentes. CSS de verdade, :has(:checked); o botão segue o modo claro ou escuro do site.

Experimente: quatro variantes, dois tamanhos, um ícone opcional. O botão é um componente só, e a linha de código embaixo dele muda com as suas escolhas. Na biblioteca do Harbour no Figma é igual: um conjunto de componentes com as propriedades Variant, Size e Show icon, com os mesmos valores.


2. Três tipos de flexibilidade

O que é Use para Exemplo no Harbour
Variante Uma versão desenhada, de uma lista fixa Mudanças que mexem em várias partes de uma vez: importância, tamanho, estado variant do Button: primary, secondary, ghost, danger
Propriedade Um pequeno interruptor: liga e desliga, um texto, uma troca Uma parte que aparece ou some, um rótulo, um ícone aninhado Show icon (booleana), Label (texto), Icon (troca de instância) do Button
Slot Uma área aberta que recebe outro conteúdo Conteúdo que o sistema não consegue prever O corpo de um Dialog; a área de detalhes do Ticket card

O Figma tem um tipo de propriedade para cada um desses: variante, booleana, texto, troca de instância e slot (Figma Help, Explore component properties). O próprio Figma, no caso do ícone, recomenda o mesmo que a tabela: em vez de criar variantes para cada estado, aplicar uma propriedade booleana à visibilidade da camada do ícone.


3. Variantes se multiplicam

Variantes são a opção mais clara para quem usa a biblioteca, e a mais cara para quem a mantém. Elas se multiplicam.

  • O Button do Harbour: 4 variantes × 2 tamanhos = 8 frames.
  • Coloque o ícone como variante em vez de booleana: × 2 = 16.
  • Coloque os cinco estados como variante (repouso, hover, foco, desativado, carregando): × 5 = 80.
  • Coloque claro e escuro como variantes em vez de modos de variável: × 2 = 160.

Cada um desses frames precisa ser desenhado, mantido em sincronia e conferido quando um token muda. Por isso o ícone é booleana, o rótulo é propriedade de texto, e claro e escuro são modos de variável (Temas e modos), não variantes. Os únicos eixos que continuam como variantes são os que mudam o design de verdade: importância, tamanho e estado.

Um teste rápido: se dois valores de um eixo diferem em uma camada só, é propriedade, não variante.


4. Slots: espaço para o que você não prevê

Alguns componentes guardam conteúdo que o sistema não tem como saber antes. Um diálogo pode fazer uma pergunta, mostrar um formulário ou listar três opções. Um card pode guardar um bilhete, uma cabine ou uma refeição. Antes dos slots, as bibliotecas no Figma simulavam isso com uma dúzia de camadas escondidas ou com uma instância de "placeholder", e as pessoas desvinculavam o componente para conseguir o que precisavam.

O Figma descreve os slots como áreas flexíveis dentro dos componentes principais, que deixam você adicionar, redimensionar e organizar conteúdo numa instância sem precisar desvinculá-la. Dá para definir instâncias preferidas para um slot e um número mínimo ou máximo de camadas (Figma Help, slots). Use esses limites: o slot de detalhes do Ticket card do Harbour prefere o componente Detail item e aceita no máximo quatro.

O código teve slots primeiro. No React, tudo o que você coloca entre as tags de um componente chega como children; a documentação do React descreve isso como um "buraco" que o componente pai pode "preencher" (React, Passing JSX as children). Os web components têm um elemento <slot> para a mesma ideia (MDN, slot). Um slot do Figma que corresponde a um slot no código é uma coisa a menos para explicar no handoff. A quarta lição deste passo vai mais longe: Composição em vez de configuração.


5. Os mesmos nomes dos dois lados

O seletor de variantes lá em cima escreve variant="secondary" porque esse é o nome no código e no Figma. Parece óbvio. Na prática, as bibliotecas se afastam: o Figma diz Type=Outline, o código diz variant="secondary", a documentação diz "botão secundário". Três nomes para uma coisa só.

As regras que o Harbour usa:

  • Nomes de propriedade no estilo do código, nos dois lugares: variant, size, iconStart. O Figma aceita qualquer nome, então use o do código.
  • Valores em minúsculas, de uma lista fixa: primary, não Primary num lugar e Main em outro.
  • A mesma ordem: variante, tamanho, depois estados. Designers leem o painel nessa ordem; desenvolvedores leem as props nessa ordem.
  • Danger é um significado, não uma cor. O Carbon trata danger como um tipo próprio de botão, para ações que podem ter efeitos destrutivos sobre os dados da pessoa (Carbon, Button). O Harbour faz o mesmo, então a Skiff pode usar outra cor sem renomear nada.

Quando os nomes batem, as ferramentas conseguem ligá-los. Code Connect e a ponte entre design e código mostra como.


6. Erros comuns

  • Transformar toda diferença em variante, até o conjunto ter centenas de frames.
  • Usar variante para claro e escuro em vez de modos de variável.
  • Slots sem limite, e o "card" acaba guardando uma página inteira.
  • Nomes diferentes para a mesma propriedade no Figma e no código.
  • Uma booleana que muda três coisas de uma vez: é uma variante fingindo ser interruptor.
  • Variantes com nome de aparência ("Azul", "Contorno") em vez de significado ("primary", "secondary").

7. Vocabulário

Termo Significado
Variante Uma versão desenhada de uma lista fixa, como variant=danger
Conjunto de componentes No Figma, todas as variantes de um componente, agrupadas
Propriedade booleana Um interruptor de liga e desliga, geralmente mostrando ou escondendo uma camada
Troca de instância Uma propriedade que troca um componente aninhado por outro, como o ícone
Slot Uma área aberta num componente que recebe outro conteúdo
Instâncias preferidas Os componentes que o Figma sugere para um slot ou uma troca

8. Experimente (sem ferramentas)

  1. Pegue um componente com muitas versões num produto que você conhece: um card, um alerta, um item de lista.
  2. Liste tudo o que muda de uma versão para outra.
  3. Classifique cada mudança como variante, propriedade ou slot, usando o teste da seção 3.
  4. Multiplique as suas variantes. Quantos frames a biblioteca precisaria?

Perguntas para refletir: Que mudança você quis transformar em variante e acabou sendo propriedade? Que parte do componente é, na verdade, uma área aberta?


9. Se você já pratica

  • Audite o seu maior conjunto de componentes: conte os frames e encontre os eixos que diferem em uma camada só.
  • Leve claro, escuro e densidade para modos de variável, se ainda forem variantes.
  • Defina instâncias preferidas e limites de camadas em todo slot, e documente o motivo.
  • Acrescente uma checagem automática ou uma pergunta na revisão: "Os nomes das propriedades batem com o código?"

Checklist

Para saber mais

Livros, cursos e vídeos para ir mais fundo

Os links dos livros são de afiliado da Amazon: como associado, recebo por compras qualificadas, sem custo a mais para você.

Relacionadas

Anatomia e API de um componente · Estados e casos-limite · Composição em vez de configuração · Temas e modos · Montar uma biblioteca no Figma · Code Connect e a ponte entre design e código · Desenhe um componente com variantes no Figma · Checklist da API de um componente

Salvo só neste dispositivo.

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