Jamdesk Documentation logo

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:

Primária
#3b82f6
Sucesso
#22c55e
Aviso
#f59e0b
Erro
#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:

Cores da marca
Primária#3b82f6
Secundária#6366f1
Cores de feedback
Sucesso#22c55e
Erro#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ãoExemploUsar para
Semânticosuccess, error, warningCores de feedback
Escala numéricaprimary-500, gray-100Paletas de cores
Descritivobrand-blue, accent-goldCores da marca

Cores adaptadas ao tema

Defina cores diferentes para os modos claro e escuro passando um objeto com as propriedades light e dark:

Theme
Plano de fundo
#ffffff
Theme
Primeiro plano
#171717
Theme
Borda
#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:

Hexadecimal
#3b82f6
RGB
rgb(59, 130, 246)
RGBA
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: compact

Estilo do layout: compact (grade) ou table (linhas agrupadas).

node

Elementos ColorItem ou ColorRow.

ColorRow

string

Rótulo exibido acima da linha.

node

Elementos ColorItem.

ColorItem

string

Nome de exibição da cor.

string | object

Valor da cor como string CSS ou { light: string, dark: string } para cores adaptadas ao tema.

O que vem a seguir?

Visão geral dos componentes

Consulte todos os componentes disponíveis

Fundamentos de MDX

Aprenda a usar componentes em MDX