颜色使用规范
返回入口 · 文档整理版 0.1 · 2026-10-27
1. 背景与适用范围
用户确认:入职时项目没有基础规范,同一色系内有十几种相近颜色;在需求设计中合并近似色,制定色系与十级色阶标准。具体历史色值总数和逐项归并映射未留存于本次已核查材料中,不虚构前后对照。
以下将规范记录与这份代码副本的实现值并列,差异不等于设计错误,也不等于代码错误。涉及差异的任务需先确认版本,不自动改值。
2. 从基础色到界面角色
- 基础层:base.less 中的色板原值,如 @color-teal-60。
- 使用层:semantic.less 中按用途命名的角色,如 @color-text-1;它通常指向 CSS 变量并保留基础值作为回退。
- 主题层:css-vars.less 定义明暗主题下的角色值。默认主题与暗色主题各自有明确选择器。
页面优先使用语义角色。这里是对已读取文件的结构说明,不是对整站运行结果的验证。
3. 主要色系的色阶
下表“规范”来自项目归档 Skill,“代码”来自同一代码副本的 base.less。统一展示原色板的亮色记录,主题映射另见后文。十级基础表没有包含所有衍生状态或例外档位。
生财绿
| 色阶 | 规范记录 | 代码副本 | 状态 |
|---|---|---|---|
| 10 | #E9FFF8 |
#F1FAF8 |
待确认,禁止静默替换 |
| 20 | #BCEDDD |
#C5EBDE |
待确认,禁止静默替换 |
| 30 | #95DBC7 |
#95DBC7 |
一致 |
| 40 | #72C9B3 |
#72C9B3 |
一致 |
| 50 | #51B7A1 |
#51B7A1 |
一致 |
| 60 | #36A590 |
#36A590 |
一致 |
| 70 | #248F80 |
#248F80 |
一致 |
| 80 | #14796D |
#14796D |
一致 |
| 90 | #07645B |
#07645B |
一致 |
| 100 | #004D49 |
#004D49 |
一致 |
橘色
| 色阶 | 规范记录 | 代码副本 | 状态 |
|---|---|---|---|
| 10 | #FFF7E9 |
#FFF7E9 |
一致 |
| 20 | #FFE4BA |
#FFE4BA |
一致 |
| 30 | #FFCF8B |
#FFCF8B |
一致 |
| 40 | #FFB65D |
#FFB65D |
一致 |
| 50 | #FF9A2F |
#FF9A2F |
一致 |
| 60 | #FF7D00 |
#FF7D00 |
一致 |
| 70 | #D25F00 |
#D25F00 |
一致 |
| 80 | #A64501 |
#A64501 |
一致 |
| 90 | #792E00 |
#792E00 |
一致 |
| 100 | #4D1B01 |
#4D1B01 |
一致 |
湖蓝色
| 色阶 | 规范记录 | 代码副本 | 状态 |
|---|---|---|---|
| 10 | #E9FFFC |
#E9FFFC |
一致 |
| 20 | #B3F6EE |
#B3F6EE |
一致 |
| 30 | #82EDE4 |
#82EDE4 |
一致 |
| 40 | #54E3DC |
#54E3DC |
一致 |
| 50 | #29D9D6 |
#29D9D6 |
一致 |
| 60 | #03CBD0 |
#03CBD0 |
一致 |
| 70 | #01A7AF |
#01A7AF |
一致 |
| 80 | #00828E |
#00828E |
一致 |
| 90 | #00616E |
#00616E |
一致 |
| 100 | #00414E |
#00414E |
一致 |
灰色
| 色阶 | 规范记录 | 代码副本 | 状态 |
|---|---|---|---|
| 10 | #F5F6F7 |
#F5F6F7 |
一致 |
| 20 | #E8EBED |
#E8EBED |
一致 |
| 30 | #D2D5DB |
#D2D5DB |
一致 |
| 40 | #BDC1C7 |
#BDC1C7 |
一致 |
| 50 | #979CA3 |
#979CA3 |
一致 |
| 60 | #757980 |
#757980 |
一致 |
| 70 | #5D6065 |
#5D6065 |
一致 |
| 80 | #3B3D40 |
#3B3D40 |
一致 |
| 90 | #242528 |
#242528 |
一致 |
| 100 | #0A0A0A |
#0A0A0A |
一致 |
生财绿代码中还存在 teal-15(#E1FAF6)和 teal-55(#3A9F8D)。它们不是规范十档表中的常规档位,本次不删除、不将其自动纳入新标准。墨蓝色归档规范列六档,不能为凑十级生成新颜色。
4. 常用语义颜色与明暗对应
以下值按 base.less 与 css-vars.less 静态解析,并与已读 Skill 的相应语义表核对。只说明此代码副本的定义;没有运行页面进行视觉验收。颜色的可读性需要结合具体背景、字号和状态检查。
| 用途 | CSS 角色 | 明亮 | 暗黑 |
|---|---|---|---|
| 品牌主色 | --color-primary-6 |
#36A590 |
#51B7A1 |
| 主要文字 | --color-text-1 |
#242528 |
#F5F6F7 |
| 次要文字 | --color-text-2 |
#3B3D40 |
#E8EBED |
| 辅助文字 | --color-text-3 |
#757980 |
#BDC1C7 |
| 占位文字 | --color-text-4 |
#BDC1C7 |
#979CA3 |
| 链接 | --color-text-5 |
#586E93 |
#72C9B3 |
| 禁用文字 | --color-text-6 |
#D2D5DB |
#757980 |
| 内容/卡片背景 | --color-fill-1 |
#FFFFFF |
#1A1B1E |
| 页面背景 | --color-surface-canvas |
#F2F3F5 |
#0D0E10 |
| 常规边框 | --color-border-2 |
#E8EBED |
#5D6065 |
| 模态遮罩 | --color-overlay-a60 |
rgba(0, 0, 0, 0.6) |
rgba(0, 0, 0, 0.75) |
| 橘色强调 | --color-accent-orange-6 |
#FF7D00 |
#FF9A2F |
| 成功反馈 | --color-success-6 |
#52C41A |
#D3F3B8 |
| 警告反馈 | --color-warning-6 |
#FA9A1D |
#FEEBBF |
| 错误反馈 | --color-danger-6 |
#F54A45 |
#FDD0C6 |
| 信息反馈 | --color-info-6 |
#327CFB |
#C3E1FE |
| AI 品牌色 | --color-ai-brand |
#00CBD0 |
#00E5E9 |
黑白透明色、角色标签和其他扩展变量仍保留在源文件,按真实需求查用;本版不把它们伪装为新增的个人设计成果。AI 品牌色只是产品功能配色,与是否具备 AI 协作能力是两回事。
5. 用法与限制
规范已有要求:
- 角色名保持项目现有命名:text/fill/surface/border/overlay 等。不要为了文档整齐重命名代码中的变量。
- 同一元素在明暗模式中优先引用同一个语义角色,主题层负责映射。不要把所有颜色简单反转,也不要从浅色 HEX 现场推算暗色值。
- 迁移旧颜色时,按根目录 CLAUDE.md 的要求核对原色值与目标变量。没有精确对应时,沿用模块级主题变量方案并确认用途,不做近似替换。
- 湖蓝色的原色板名、语义名和 CSS 名不完全相同。代码实际提供的是 –color-shqblue-;不要把旧文档中 –color-lakeblue- 的表头直接当成可调用 CSS 变量。
本次新增的检查建议:
- 状态反馈同时提供必要的文案或图形提示,避免仅靠红绿区分。
- 在实际背景上检查正文、辅助文字、禁用状态与链接;本包不声明已通过可访问性审核。
- 渐变没有在本次读取的基础规范中形成可复用规则,暂不新增渐变标准。
6. 示例
以下是本次编写的使用示例,不是历史页面截图或已运行组件:
.content-sample {
color: var(--color-text-1);
background: var(--color-fill-1);
border: 1px solid var(--color-border-2);
}
本例需要目标项目先加载现有主题变量;暗色切换和样式覆盖仍须在实际项目验证。
7. 必查差异
生财绿浅色两档、额外档位、状态色旧速查表、湖蓝命名等见差异记录。基础色板某一行的“映射”说明不能覆盖更具体的语义变量定义。