---
title: 颜色
description: Color 组件以色板形式展示颜色，适用于记录设计系统、品牌指南或任何颜色规范。
---

> **For AI agents:** the complete documentation index is at [llms.txt](/docs/llms.txt). Append `.md` to any page URL for its markdown version.

Color 以可点击复制的色块显示十六进制、RGB 和 RGBA 值。它提供两种布局变体：紧凑网格和分组表格，并内置浅色和深色模式支持。

在以下情况下使用 Color：
- **记录包含品牌颜色的设计系统**
- **展示浅色和深色模式的主题颜色**
- **显示颜色刻度**（primary-100 到 primary-900）
- **分享包含十六进制/RGB 值的品牌指南**

## 用法

```mdx
<Color>
  <ColorItem name="Primary" value="#635BFF" />
</Color>
```

## 紧凑变体

默认布局以响应式网格显示颜色：

<Color>
  <ColorItem name="Primary" value="#3b82f6" />
  <ColorItem name="Success" value="#22c55e" />
  <ColorItem name="Warning" value="#f59e0b" />
  <ColorItem name="Error" value="#ef4444" />
</Color>

```mdx
<Color>
  <ColorItem name="Primary" value="#3b82f6" />
  <ColorItem name="Success" value="#22c55e" />
  <ColorItem name="Warning" value="#f59e0b" />
  <ColorItem name="Error" value="#ef4444" />
</Color>
```

## 表格变体

将颜色分组到带标签的行中，以便整理色板：

<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>

```mdx
<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>
```

## 颜色命名约定

| 模式 | 示例 | 用途 |
|---------|---------|---------|
| 语义化 | `success`, `error`, `warning` | 反馈颜色 |
| 数值刻度 | `primary-500`, `gray-100` | 色板 |
| 描述性 | `brand-blue`, `accent-gold` | 品牌颜色 |

## 主题感知颜色

通过传入包含 `light` 和 `dark` 属性的对象，为浅色和深色模式定义不同的颜色：

<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>

```mdx
<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>
```

## 颜色格式

该组件支持标准 CSS 颜色格式：

<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>

```mdx
<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>
```

## 属性

### Color

<ParamField name="variant" type="string" default="compact">
  布局样式：`compact`（网格）或 `table`（分组行）。
</ParamField>

<ParamField name="children" type="node">
  `ColorItem` 或 `ColorRow` 元素。
</ParamField>

### ColorRow

<ParamField name="title" type="string">
  显示在行上方的标签。
</ParamField>

<ParamField name="children" type="node">
  `ColorItem` 元素。
</ParamField>

### ColorItem

<ParamField name="name" type="string">
  颜色的显示名称。
</ParamField>

<ParamField name="value" type="string | object">
  CSS 字符串形式的颜色值；对于主题感知颜色，则使用 `{ light: string, dark: string }`。
</ParamField>

## 接下来做什么？

<Columns cols={2}>
  <Card title="组件概览" icon="puzzle-piece" href="/cn/components/overview">
    浏览所有可用组件
  </Card>
  <Card title="MDX 基础" icon="file-code" href="/cn/content/mdx-basics">
    了解如何在 MDX 中使用组件
  </Card>
</Columns>