UI 视觉设计 / 知识点
色彩与配色术语速查手册
UI 语义色
设计系统中的基础颜色值或色阶,如 blue-600、gray-100;它描述“值是什么”,不直接说明应用场景。
定义
**Primitive Color(原始色)**是 Color System 的底层基础值。
例如:
blue.50
blue.100
blue.600
gray.900边界
Primitive 通常不应被业务组件直接大量引用。
映射
Primitive
↓
Semantic
↓
Component常见误区
如果组件直接绑定 blue.600,主题化和品牌切换会变得困难。
只服务某个组件或状态的局部颜色角色,如 button-primary-bg-hover;应在确有局部差异时使用。
定义
Component Color 是组件层级的颜色 Token。
例如:
button.primary.background
button.primary.background.hover边界
如果全局 Semantic Color 已经足够表达,应优先复用,而不是为每个组件重复创建。
常见误区
组件色数量无限膨胀会导致 Color Token 系统失控。
页面或大区域最底层的颜色角色,用于建立整体环境;通常与 Surface Layer 区分。
定义
**Background Color(背景色)**通常是页面或应用场景的基础底色。
对比
- Background:环境底层。
- Surface:承载内容或组件的层。
最小例子
页面背景为浅灰,Card Surface 为白色,可以自然形成层级。
常见误区
所有区域都使用纯白,会让层级只能依赖阴影和边框。
用于 Card、Panel、Sheet、Dialog 等承载内容的表面颜色;常通过不同层级 Surface 建立深度和分组。
定义
**Surface Color(表面色)**用于承载内容和交互组件。
常见层级
surface.base
surface.raised
surface.overlay边界
Surface 不一定比 Background 更亮;Dark Mode 中可能采用不同逻辑。
常见误区
Surface 层级不应只靠阴影,颜色差异、边框和 Elevation 都可以共同表达。
位于背景或 Surface 上方的主要内容颜色总称,常包括 Text、Icon 和重要图形元素。
定义
**Foreground Color(前景色)**是位于某个 Background / Surface 上的内容颜色。
常见组成
- Text
- Icon
- Stroke
- Active content
边界
Foreground 是结构关系概念,不等同于 Text Color。
常见误区
同一个 Foreground Color 不一定适合所有 Surface,需要根据 Contrast 重新验证。
页面正文和关键信息使用的最高优先级文字颜色,通常具有最强可读性和对比度。
定义
**Primary Text Color(主文本色)**用于最重要的阅读信息。
常见用途
- Heading
- Body
- Critical values
层级
Primary
Secondary
Tertiary / Muted
Disabled常见误区
Primary Text 不一定必须是纯黑;深灰往往能提供更柔和的视觉体验。
用于辅助说明、元数据和次级信息的文字颜色,视觉权重低于 Primary Text,但仍需满足可读性要求。
定义
**Secondary Text Color(次级文本色)**用于信息层级较低的文字。
常见用途
- Metadata
- Supporting text
- Description
边界
Secondary 只是视觉弱化,不等于可以低对比。
常见误区
“次要信息”经常被错误地做成几乎看不清的浅灰。
用于弱化背景、文本、图标或边框的低视觉权重颜色角色;应降低强调而不是降低到不可辨。
定义
**Muted Color(弱化色)**用于降低视觉关注度。
常见用途
- Secondary icon
- Muted surface
- Low-emphasis border
边界
Muted 不是 Disabled,也不是“任意浅灰”。
常见误区
把所有非主内容都设为 Muted 会让层级缺乏中间梯度。
用于组件边界、输入框、卡片和分隔结构的颜色角色;常按 subtle、default、strong、focus 等语义细分。
定义
**Border Color(边框色)**用于表达界面结构边界。
常见语义
border.subtle
border.default
border.strong
border.focus
border.danger价值
边框是建立层级和可操作性的低成本方式。
常见误区
极浅边框在高亮屏幕或低视力场景下可能完全消失。
用于分隔相邻内容区块或列表项的低强调颜色,通常比 Border 更弱、更偏结构提示。
定义
**Divider Color(分隔线色)**用于轻量分组和结构划分。
对比
- Border:围合对象边界。
- Divider:分隔相邻区域。
最小例子
列表项目之间 1px 淡线可以使用 Divider Token。
常见误区
过重 Divider 会让页面显得像表格网格,增加视觉噪音。
用于链接、按钮、选中、Hover、Pressed 等交互状态的颜色角色;应形成完整 State System。
定义
**Interactive Color(交互色)**服务可操作元素及其状态。
常见状态
Default
Hover
Pressed
Selected
Focus
Disabled价值
让用户理解:
- 什么可操作
- 当前状态
- 操作反馈
常见误区
只定义一个 Primary Color,却没有 Hover / Pressed / Focus 颜色,会导致实现临时发挥。
用于表示任务完成、状态正常或结果成功的语义颜色;常见为绿色系,但语义不应只靠颜色传达。
定义
**Success Color(成功色)**表示正向、成功或完成状态。
常见场景
- Payment success
- Validation success
- Online / healthy status
边界
Success 不能只靠绿色表达,应结合:
- Text
- Icon
- Label
常见误区
品牌绿色与 Success Green 应根据语义分别建模,不必强行共用。
主题与模式
用于提示风险、需注意但尚未失败的状态色;常见为黄、橙色系,应与 Error / Danger 明确区分。
定义
**Warning Color(警告色)**表示:
需要注意,但不一定已经失败。
常见场景
- Approaching limit
- Unsaved change
- Potential risk
对比
- Warning:风险提示。
- Error / Danger:错误或破坏性后果。
常见误区
Warning 与 Error 使用同一颜色,会降低语义清晰度。
用于表示输入错误、系统失败或任务无法继续的语义色;通常为红色系,但必须配合明确错误文案。
定义
**Error Color(错误色)**用于表示已发生的问题。
常见用途
- Invalid input
- Failed request
- Form error
- System error
边界
Error 是“状态”,Danger 更偏“动作风险”。
常见误区
只有红色 Border 而没有错误文本,不足以帮助用户理解和修复。
用于删除、永久操作、权限撤销等高风险动作的语义色;强调潜在后果,不等同于 Error State。
定义
**Danger Color(危险色)**用于表示一个动作可能产生严重后果。
常见用途
- Delete
- Remove access
- Reset
- Destructive action
对比
Error → 已经发生问题
Danger → 即将执行高风险动作常见误区
所有 Cancel / Close 都不应自动使用 Danger。
用于中性提示、说明或系统信息的语义色,常见为蓝色或青色,但应服从整体语义体系。
定义
**Info Color(信息色)**用于表达中性、说明性消息。
常见场景
- Notice
- Tip
- System information
边界
Info 不应与 Primary Action 颜色产生混淆。
常见误区
如果 Primary 和 Info 都用同一蓝色且视觉角色完全相同,用户难以区分“可操作”和“只是提示”。
通过一组 Color Token 映射改变整体视觉环境,如品牌主题、Light Theme、Dark Theme;语义角色应保持稳定。
定义
**Theme(主题)**通过替换 Token Mapping 改变界面视觉。
结构
Semantic Token
↓
Theme Mapping
↓
Primitive Value价值
组件继续使用相同语义名称,不需要逐个改颜色。
常见误区
主题切换如果依赖组件内部硬编码颜色,说明 Color System 抽象不足。
以较亮 Background / Surface 为主的主题模式;需要明确 Text、Border、Surface、Overlay 与状态色层级。
定义
**Light Mode(浅色模式)**以高 Lightness Surface 为主。
典型层级
- Light background
- Dark foreground
- Subtle border
- Controlled shadows
边界
Light Mode 不是“所有背景都纯白”。
常见误区
只定义白背景和黑文字,无法形成完整 Surface Hierarchy。
以较暗 Background / Surface 为主的主题模式;不是简单颜色反转,需要重新设计 Surface、Contrast、Chroma 和媒体资源。
定义
**Dark Mode(深色模式)**是在较低 Lightness Surface 上建立完整界面层级。
需要重新考虑
- Surface hierarchy
- Text contrast
- Status colors
- Chroma
- Elevation
- Images
常见误区
直接执行“白变黑、黑变白”通常会得到刺眼、层级混乱的结果。
通过更强前景/背景差异和更明确边界提升可辨识度的主题策略;可以由产品提供,也可能由系统强制颜色实现。
定义
**High Contrast Theme(高对比主题)**服务对比敏感和低视力用户。
可能强化
- Text contrast
- Border
- Focus ring
- Selected state
边界
它不等同于“所有颜色都最饱和”。
常见误区
高对比主要关注可辨识性,而不是视觉刺激强度。