UI 视觉设计 / 知识点
UI 配色实践速查手册
可访问性与验收
Focus 是操作定位信息,必须在不同 Surface、Button 和 Theme 上保持足够清晰。
目标
保证 Focus 不会在某些组件上“消失”。
检查组合
focus on white
focus on gray
focus on primary
focus on danger
focus in dark mode常见误区
只在默认白底截图里检查 Focus Ring。
任何 Alpha Text、Overlay、Scrim 都应基于最终 Composited Color 检查,而不是原始颜色。
目标
得到真实结果。
计算思路
foreground + alpha + background
→ composited foreground
→ contrast高风险
- Disabled
- Placeholder
- Overlay text
- Glass UI
常见误区
“黑色 60%”不是固定 Contrast 值。
Light Theme 的所有 Contrast 结果不能直接复用到 Dark Theme,必须重新验收实际 Token Pair。
目标
保证 Dark Theme 不是“视觉主题”,而是完整产品状态。
最少重新检查
- Primary/Secondary text
- Link
- Button
- Focus
- Status
- Border
- Overlay
常见误区
Light Theme 通过 AA,就认为 Dark Theme 也自动通过。
高质量配色交付不只给 Palette,还应给每个语义角色的前景/背景搭配和使用边界。
目标
降低开发误用。
推荐交付
Token
Role
Light value
Dark value
Allowed background
Contrast note
Do / Don't最小例子
text.inverse 明确只用于深色 Surface,而不是任意背景。
常见误区
只给一张 Figma 色板,开发无法知道颜色什么时候该用。
设计系统与工程
第一版 Color Token 不必设计五六层,Primitive + Semantic 通常已经能解决大部分主题和一致性问题。
目标
降低系统复杂度。
推荐起点
Primitive
↓
Semantic需要组件独立 Theme 时,再增加:
Component Token常见误区
一开始就建立 Global → Alias → Semantic → Context → Component → State 六层,会让团队没人敢改。
业务设计师和开发应优先消费 Semantic Token,避免直接选择 blue.400 / gray.700。
目标
防止语义失控。
推荐
业务层看到:
text.secondary
surface.selected
action.primary而不是:
gray.600
blue.100
blue.600常见误区
“设计师更自由”往往意味着系统逐渐失去一致性。
Hover、Pressed、Selected、Disabled 不应靠开发现场计算,应该进入 Token 或 Component Spec。
目标
保持跨平台一致。
推荐
action.primary.default
action.primary.hover
action.primary.pressed或者由 Component Token 映射。
常见误区
Web 用 darken 8%,iOS 手调一个颜色,Android 再调一个,最终会出现三套状态色。
组件应消费 Token,而不是直接写具体颜色,否则 Theme 和品牌切换成本会快速上升。
目标
让颜色变更可集中治理。
不推荐
Button {
background: #2563EB
}推荐
Button {
background: var(--action-primary)
}常见误区
“只有这一处,所以先写死”会慢慢累积成 Color Debt。
好 Token 名称在颜色真正改变后仍成立,因此优先用 role/state,而不是 blue/light/dark。
目标
让 Token 长寿。
推荐
text.primary
surface.selected
border.focus
status.warning谨慎
light-blue
dark-gray-text常见误区
名称里写具体 Hue,会让品牌切换和 Dark Theme 变得尴尬。
组件只引用 Semantic Token,Theme 层负责把语义映射到具体 Primitive。
目标
实现真正 Themeable UI。
架构
Component
↓
Semantic Token
↓
Theme Mapping
↓
Primitive价值
同一 Button Component 可以在:
- Light
- Dark
- Brand A
- Brand B
中复用。
常见误区
组件内部写 if dark then #...,会让 Theme Logic 散落各处。
修改一个 Primitive Color 可能影响多个 Semantic 和 Component,发布前应做依赖检查和 Visual Regression。
目标
避免“一改全站变色”。
推荐流程
Token change
↓
Dependency list
↓
Contrast QA
↓
Visual regression
↓
Release常见误区
只在色板页面看新颜色,而不查看真实组件组合。
Color Token 只是能力,真正减少误用还需要明确使用场景和反例。
目标
回答:
- 什么场景用 Primary?
- 什么不能用 Accent?
- Error 能否用于删除按钮?
- Surface Tint 用多大面积?
推荐
每类 Color Role 提供:
When to use
When not to use
Example
Anti-pattern常见误区
没有 Guideline 的 Palette 会快速被团队“自由发挥”。
设计系统最好维护一页自动或半自动展示所有 Token Pair、状态和 Theme,用于回归检查。
目标
集中检查:
- Light / Dark
- Text pairs
- Button states
- Status states
- Border
- Focus
- Charts
价值
颜色改一次,可以快速看到整体影响。
常见误区
只在真实业务页面里零散检查,很难覆盖所有状态。
重命名 Token、改变语义或大幅改变 Contrast 可能是破坏性变更,应有版本和迁移说明。
目标
让 Color System 可演进。
Breaking 示例
remove status.warning
rename text.muted
change semantic meaning非 Breaking 可能包括
在保持语义和可接受视觉范围下调整具体 Primitive Value。
常见误区
“只是换个颜色”不一定是小改,可能影响品牌、A11y 和大量截图。