UI 视觉设计 / 系统课时
使用语义颜色适配明暗外观
使用语义颜色适配明暗外观
同一张任务列表在浅色模式下清楚,并不代表切到深色或增强对比度后仍然可读。本课把文字、背景、强调色和状态色按用途映射到系统语义色,再用四组显示条件检查颜色层级与可访问性。
学习目标
- 根据界面职责选用文字、背景、操作和状态语义色。
- 为必要的品牌强调色配置浅色、深色与高对比度变体。
- 使用四组显示条件检查对比度、层次和状态信息。
为任务页面建立语义色映射
以“今日任务”列表为例,不为每个组件直接指定 RGB,而是先标记用途,再选对应颜色。下面是 iOS / iPadOS 可交付给开发者的映射表,名称以 Apple UIKit 语义色文档 为准。
| 界面职责 | UIKit 语义色 | SwiftUI 对应写法 |
|---|---|---|
| 任务标题 | UIColor.label |
.foregroundStyle(.primary) |
| 截止日期等次要文字 | UIColor.secondaryLabel |
.foregroundStyle(.secondary) |
| 页面底色 | UIColor.systemBackground |
Color(uiColor: .systemBackground) |
| 任务卡片底色 | UIColor.secondarySystemBackground |
Color(uiColor: .secondarySystemBackground) |
| 链接与主要操作 | UIColor.tintColor |
Color.accentColor |
| 逾期状态 | UIColor.systemRed |
Color(uiColor: .systemRed) |
| 列表分隔线 | UIColor.separator |
Color(uiColor: .separator) |
系统语义色根据当前外观解析,不能把其中某次显示出的十六进制值抄成固定样式。错误做法是把任务标题永久设为 #000000、卡片永久设为 #FFFFFF:切换暗色后,标题可能消失,卡片也会格外刺眼。状态颜色还要配合“逾期”等文字或图标,不能只靠红点传意。
对照浅色、深色和增强对比度
让同一任务页保持相同内容:主标题“今日任务”、辅助说明“3 项待完成”、卡片“提交周报”、状态“逾期”和主要操作“新建任务”。改变的仅是系统外观及颜色解析结果,不应改变信息的主次关系。

检查时先比较主标题与次级说明能否一眼区分,再检查卡片边界、操作入口及逾期标签。增强对比度不是简单把整页调亮,而是让需要区分的前景与背景更容易辨认。
为品牌强调色配置动态变体
系统色优先;只有品牌链接、特殊操作确实需要自定义时,才建立颜色资源。以下以 Xcode 15 及更新版本的 AccentColor 为例;这是演示用候选值,投入产品前仍需针对实际背景检查。
- 打开工程的
Assets.xcassets,选择现有AccentColor;没有时点击底部+,选择New Color Set并命名为AccentColor。 - 在右侧 Attributes Inspector 的
Appearances中选择Any, Dark,并启用High Contrast,为四种条件分别准备颜色槽位。 - 在各槽位填入下表的 sRGB 值;
Any为默认浅色方案,Dark对应深色方案。
| 颜色槽位 | 示例色值 | 检查背景 |
|---|---|---|
| Any | #1D4ED8 |
浅色页面 |
| Dark | #93C5FD |
深色页面 |
| Any + High Contrast | #1E40AF |
浅色高对比度 |
| Dark + High Contrast | #BFDBFE |
深色高对比度 |

对照界面示意核对四个颜色槽位。将该资源用于主要操作着色,而不是替换正文语义色。若做成实心按钮,必须另外测量按钮文字与填充色的对比度;表中数值只示范链接、图标等前景强调色,不保证白字按钮可读。
在四组设置下验收
在 iPhone 或 iPad 打开“设置 → 显示与亮度”,切换浅色和深色;再进入“设置 → 辅助功能 → 显示与文字大小 → 增强对比度”,分别关闭与开启。两种外观乘以两档对比度,共检查四组。
| 显示条件 | 必查项目 |
|---|---|
| 浅色 + 标准 | 黑白层级、链接可识别 |
| 深色 + 标准 | 无固定白卡片、无黑字消失 |
| 浅色 + 增强对比度 | 辅助文字和分隔边界更易辨认 |
| 深色 + 增强对比度 | 深色卡片分层清楚、状态可识别 |
对自定义的普通字号文本,前景与实际背景的对比度至少按 4.5:1 检查,小字可争取 7:1;不要只拿色卡与纯白比较。为每组保存一张实机或模拟器截屏,核对“逾期”既有文字也有图标,且链接与静态说明不会只靠颜色区分。
如果只有某一组失效,先追查固定 RGB、缺失的 Color Set 变体或把动态 UIColor 提前转换为固定色值的实现;不要用一套新硬编码颜色去覆盖所有外观。