UI 视觉设计 / 系统课时
处理颜色继承与主题切换
处理颜色继承与主题切换
图标颜色最容易在接入设计系统后失控:同一枚图标既可能跟随文字色,也可能需要状态色、多色品牌色或深浅主题替换。本节给出一套从颜色所有权、语义令牌到运行时验证的规则,让图标在不同主题中保持可维护和可预测。
学习目标
- 区分继承色、固定色、多色图标和语义主题色的适用边界。
- 使用
currentColor与设计令牌建立可切换的颜色链路。 - 用最小示例验证浅色、深色和禁用状态下的实际结果。
先决定谁拥有颜色
单色功能图标应优先让外层组件拥有颜色,图标只消费颜色。Web 场景中最常见的方式是让 SVG 使用 fill="currentColor" 或 stroke="currentColor",这样按钮文字色、悬停色、禁用色和主题色可以通过同一条 CSS 规则控制。
多色品牌图标、数据可视化图标和需要多层语义的状态图标不适合强行继承单一颜色。它们应明确哪些图层固定、哪些图层来自令牌,避免主题切换时把品牌识别色或告警层级一起改掉。

用语义令牌连接主题
不要把 #222、#fff 这类颜色直接写进通用图标。应先定义语义令牌,例如前景色、弱化色、危险色,再由主题覆盖令牌值。组件只引用语义名称,图标继续继承组件的 color。
下面是一个可直接保存为 index.html 打开的完整示例。按钮中的 SVG 不写具体颜色,只通过 currentColor 跟随主题和状态。
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<title>Icon Theme Demo</title>
<style>
:root {
--fg-default: #1f2937;
--fg-danger: #b42318;
--surface: #ffffff;
}
[data-theme="dark"] {
--fg-default: #f3f4f6;
--fg-danger: #ff8a80;
--surface: #111827;
}
body {
margin: 24px;
background: var(--surface);
color: var(--fg-default);
}
.icon-button {
color: var(--fg-default);
background: transparent;
border: 1px solid currentColor;
padding: 8px 12px;
}
.icon-button.danger {
color: var(--fg-danger);
}
.icon {
width: 20px;
height: 20px;
fill: currentColor;
vertical-align: middle;
}
</style>
</head>
<body data-theme="dark">
<button class="icon-button danger">
<svg class="icon" viewBox="0 0 24 24" aria-hidden="true">
<path d="M7 4h10l1 2h3v2H3V6h3l1-2zm1 6h2v8H8v-8zm6 0h2v8h-2v-8z"/>
</svg>
删除
</button>
</body>
</html>预期结果
页面使用深色背景;“删除”按钮文字、边框和垃圾桶图标保持同一危险色。将 body 的 data-theme 改为 light 或移除后,颜色会切换到浅色主题令牌定义。实际颜色值可能因你的令牌体系不同而变化,但继承关系应保持不变。
多色与状态图标的边界
多色图标先判断颜色是否承载语义。如果只是装饰层,可以固定为中性色;如果分别表示成功、警告、错误,应分别绑定对应语义令牌,而不是让整枚图标只吃一个 currentColor。
交互状态也应由组件统一控制。默认、悬停、按下、禁用只改组件的语义色,不要在每个 SVG 文件里复制状态规则。这样设计令牌调整后,按钮、文本和图标能同步更新。
验收主题切换
交付前至少检查浅色、深色、禁用和危险状态,并验证图标与相邻文字是否使用同一语义层级。若图标需要独立颜色,也要能解释它为什么不继承组件色。最终目标不是“所有图标都会变色”,而是每种颜色来源都有明确所有者,主题变化只替换令牌,不修改图标资产本身。