Cor
O componente Color exibe paletas de cores para documentar sistemas de design, diretrizes de marca ou especificações de cores.
Color exibe valores hexadecimais, RGB e RGBA como amostras que podem ser clicadas para copiar. Ele oferece duas variantes de layout: uma grade compacta e uma tabela agrupada, com suporte integrado aos modos claro e escuro.
Use Color para:
- Documentar sistemas de design com cores da marca
- Exibir cores de tema para os modos claro e escuro
- Exibir escalas de cores (primary-100 até primary-900)
- Compartilhar diretrizes de marca com valores hexadecimais/RGB
Uso
<Color>
<ColorItem name="Primary" value="#635BFF" />
</Color>
Variante compacta
O layout padrão exibe as cores em uma grade responsiva:
#3b82f6#22c55e#f59e0b#ef4444<Color>
<ColorItem name="Primary" value="#3b82f6" />
<ColorItem name="Success" value="#22c55e" />
<ColorItem name="Warning" value="#f59e0b" />
<ColorItem name="Error" value="#ef4444" />
</Color>
Variante de tabela
Agrupe as cores em linhas identificadas para organizar as paletas:
#3b82f6#6366f1#22c55e#ef4444<Color variant="table">
<ColorRow title="Brand Colors">
<ColorItem name="Primary" value="#3b82f6" />
<ColorItem name="Secondary" value="#6366f1" />
</ColorRow>
<ColorRow title="Feedback Colors">
<ColorItem name="Success" value="#22c55e" />
<ColorItem name="Error" value="#ef4444" />
</ColorRow>
</Color>
Convenções de nomenclatura de cores
| Padrão | Exemplo | Usar para |
|---|---|---|
| Semântico | success, error, warning | Cores de feedback |
| Escala numérica | primary-500, gray-100 | Paletas de cores |
| Descritivo | brand-blue, accent-gold | Cores da marca |
Cores adaptadas ao tema
Defina cores diferentes para os modos claro e escuro passando um objeto com as propriedades light e dark:
#ffffff#171717#e5e5e5<Color>
<ColorItem name="Background" value={{ light: "#ffffff", dark: "#0a0a0a" }} />
<ColorItem name="Foreground" value={{ light: "#171717", dark: "#ededed" }} />
<ColorItem name="Border" value={{ light: "#e5e5e5", dark: "#404040" }} />
</Color>
Formatos de cor
O componente aceita formatos de cores CSS padrão:
#3b82f6rgb(59, 130, 246)rgba(59, 130, 246, 0.8)<Color>
<ColorItem name="Hex" value="#3b82f6" />
<ColorItem name="RGB" value="rgb(59, 130, 246)" />
<ColorItem name="RGBA" value="rgba(59, 130, 246, 0.8)" />
</Color>
Propriedades
Color
stringdefault: compactEstilo do layout: compact (grade) ou table (linhas agrupadas).
nodeElementos ColorItem ou ColorRow.
ColorRow
stringRótulo exibido acima da linha.
nodeElementos ColorItem.
ColorItem
stringNome de exibição da cor.
string | objectValor da cor como string CSS ou { light: string, dark: string } para cores adaptadas ao tema.
