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
<Button variant="primarysecondaryghostdanger" size="defaultcompact" iconStart="ticket">Reservar travessia</Button>
: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ãoPrimarynum lugar eMainem 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)
- Pegue um componente com muitas versões num produto que você conhece: um card, um alerta, um item de lista.
- Liste tudo o que muda de uma versão para outra.
- Classifique cada mudança como variante, propriedade ou slot, usando o teste da seção 3.
- 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
- Figma Help: Explore component properties · Create and use slots
- React, Passing JSX as children · MDN, o elemento slot
- Carbon, Button: cinco tipos, e danger como um tipo próprio
Livros, cursos e vídeos para ir mais fundo
- Design SystemsAlla KholmatovaLivro · Smashing Magazine, 2017 (Amazon)
- Atomic DesignBrad Frost2016, gratuito online (Amazon)
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