Cor
Documentação do componente Color, que exibe amostras de cores hex, RGB e RGBA em grades compactas ou tabelas agrupadas, com valores opcionais por tema
Color exibe valores hex, RGB e RGBA como amostras de cor que podem ser copiadas com um clique. Ele tem duas variantes de layout: uma grade compacta e uma tabela agrupada. Cada amostra pode receber um valor separado para cada tema.
Use Color quando:
- Documentar sistemas de design com cores de marca
- Mostrar cores de tema que mudam conforme o tema
- Exibir escalas de cor (primary-100 até primary-900)
- Compartilhar diretrizes de marca com valores hex/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 rotuladas:
#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 | Uso |
|---|---|---|
| Semântico | success, error, warning | Cores de feedback |
| Escala numérica | primary-500, gray-100 | Paletas de cor |
| Descritivo | brand-blue, accent-gold | Cores de marca |
Cores adaptadas ao tema
Passe um objeto com as propriedades light e dark para definir uma cor por tema:
#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 valores hex, RGB e RGBA:
#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 de 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 sensíveis ao tema.
