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 为例;这是演示用候选值,投入产品前仍需针对实际背景检查。

  1. 打开工程的 Assets.xcassets,选择现有 AccentColor;没有时点击底部 +,选择 New Color Set 并命名为 AccentColor。
  2. 在右侧 Attributes Inspector 的 Appearances 中选择 Any, Dark,并启用 High Contrast,为四种条件分别准备颜色槽位。
  3. 在各槽位填入下表的 sRGB 值;Any 为默认浅色方案,Dark 对应深色方案。
颜色槽位 示例色值 检查背景
Any #1D4ED8 浅色页面
Dark #93C5FD 深色页面
Any + High Contrast #1E40AF 浅色高对比度
Dark + High Contrast #BFDBFE 深色高对比度

Xcode Color Set 明暗和高对比度四槽位设置位置示意

对照界面示意核对四个颜色槽位。将该资源用于主要操作着色,而不是替换正文语义色。若做成实心按钮,必须另外测量按钮文字与填充色的对比度;表中数值只示范链接、图标等前景强调色,不保证白字按钮可读。

在四组设置下验收

在 iPhone 或 iPad 打开“设置 → 显示与亮度”,切换浅色和深色;再进入“设置 → 辅助功能 → 显示与文字大小 → 增强对比度”,分别关闭与开启。两种外观乘以两档对比度,共检查四组。

显示条件 必查项目
浅色 + 标准 黑白层级、链接可识别
深色 + 标准 无固定白卡片、无黑字消失
浅色 + 增强对比度 辅助文字和分隔边界更易辨认
深色 + 增强对比度 深色卡片分层清楚、状态可识别

对自定义的普通字号文本,前景与实际背景的对比度至少按 4.5:1 检查,小字可争取 7:1;不要只拿色卡与纯白比较。为每组保存一张实机或模拟器截屏,核对“逾期”既有文字也有图标,且链接与静态说明不会只靠颜色区分。

如果只有某一组失效,先追查固定 RGB、缺失的 Color Set 变体或把动态 UIColor 提前转换为固定色值的实现;不要用一套新硬编码颜色去覆盖所有外观。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用语义颜色适配明暗外观

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通