UI 视觉设计 / 系统课时
用 CSS 自定义属性引用语义色
用 CSS 自定义属性引用语义色
订单工作台同时提供浅色与深色主题时,如果在按钮和卡片中直接写十六进制色值,同一角色很容易出现多套颜色。本篇用 CSS 自定义属性集中定义语义色,让组件只引用“文字、表面、操作按钮”等职责,再通过一个主题属性切换整套配色。
学习目标
- 区分色值与语义角色,为文字、表面和操作按钮命名。
- 用
var()让同一份组件 CSS 适配浅色与深色主题。 - 验证最终渲染色,并定位变量缺失或被覆盖的问题。
用角色名取代散落的色值
不要在每个按钮里写 background-color: #175cd3,再为深色主题额外复制一份按钮样式。组件真正需要的是“主操作背景”,因此引用 background-color: var(--color-action-bg)。主题负责决定这个角色在当前环境下究竟取深蓝还是浅蓝。
常用命名可先覆盖 --color-page-bg(页面背景)、--color-surface(卡片表面)、--color-text(主要文字)、--color-border(边框)和 --color-action-bg(操作按钮背景)。按钮前景文字另用 --color-action-text,避免换了背景却忘记同步调整文字对比度。

运行一张可切换主题的订单卡片
将以下内容保存为 index.html,用浏览器打开。示例把主题变量定义在 :root,然后用根节点的 data-theme="dark" 覆盖同名变量。组件选择器只写一次,所有颜色都从语义入口读取。
<!doctype html>
<html lang="zh-CN" data-theme="light">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>语义颜色示例</title>
<style>
:root {
/* 浅色主题在根节点提供默认语义值。 */
--color-page-bg: #f3f6fa;
--color-surface: #ffffff;
--color-text: #172b4d;
--color-text-muted: #52647a;
--color-border: #cbd5e1;
--color-action-bg: #175cd3;
--color-action-text: #ffffff;
}
[data-theme="dark"] {
/* 切换主题只覆盖变量,不重复声明组件规则。 */
--color-page-bg: #0f172a;
--color-surface: #1e293b;
--color-text: #f8fafc;
--color-text-muted: #cbd5e1;
--color-border: #475569;
--color-action-bg: #93c5fd;
--color-action-text: #0f172a;
}
body {
margin: 0;
min-height: 100vh;
box-sizing: border-box;
padding: 32px;
font-family: system-ui, sans-serif;
background-color: var(--color-page-bg);
color: var(--color-text);
}
.order-card {
max-width: 420px;
padding: 24px;
border: 1px solid var(--color-border);
border-radius: 12px;
background-color: var(--color-surface);
}
.order-card__detail {
color: var(--color-text-muted);
}
.action-button {
padding: 10px 16px;
border: 0;
border-radius: 8px;
background-color: var(--color-action-bg);
color: var(--color-action-text);
cursor: pointer;
}
</style>
</head>
<body>
<main class="order-card">
<h1>订单 #1042</h1>
<p class="order-card__detail">待处理 · 商品 2 件</p>
<button class="action-button" id="theme-toggle" type="button">切换主题</button>
</main>
<script>
const button = document.querySelector("#theme-toggle");
button.addEventListener("click", () => {
const root = document.documentElement;
// 根节点属性变化后,后代重新获得相应语义色。
root.dataset.theme = root.dataset.theme === "light" ? "dark" : "light";
});
</script>
</body>
</html>预期结果:首次打开时,页面为浅灰背景、白色卡片和深蓝色按钮;点击“切换主题”后,页面变为深色,卡片与文字同步更新,按钮变为浅蓝底配深色文字;再次点击恢复浅色主题。
在浏览器中核对最终颜色
- 在页面上按
F12打开开发者工具,进入Elements(元素)面板,选中.action-button。 - 在
Styles(样式)中找到background-color: var(--color-action-bg),检查该变量由:root或[data-theme="dark"]提供。 - 在
Computed(计算样式)中检查background-color:浅色时应为rgb(23, 92, 211),深色时应为rgb(147, 197, 253)。再检查卡片背景分别为rgb(255, 255, 255)和rgb(30, 41, 59)。 - 修改深色主题的
--color-action-bg,确认按钮随之改变,而.action-button的 CSS 无须改动。
这些数值是本示例颜色换算后的结果;浏览器开发者工具的界面名称或颜色展示格式可能不同,但对应的实际颜色应一致。
处理变量缺失和局部覆盖
CSS 自定义属性区分大小写,--color-text 与 --Color-Text 是两个名称。写错名称且没有回退值时,依赖它的颜色声明可能失效。对于允许降级的非关键场景,可以写 border-color: var(--color-border, #cbd5e1),让变量缺失时使用后备值;后备值不能修复已经定义、但不符合颜色语法的变量。
变量遵循层叠与继承。如果某张卡片自己声明 --color-action-bg: #000000,其内部按钮就可能优先使用局部值,而不是根节点的主题值。排查时先检查按钮自身和祖先节点,再检查 :root 与主题选择器。要让所有按钮一致,删除无意的局部覆盖;要保留特殊按钮,则为其明确设定组件变体令牌。
主题切换时应成对检查按钮背景与前景色:本例浅色为深蓝配白字,深色为浅蓝配深字。交付前分别在两种主题下核对正文、按钮文字及边框的可读性,不能只确认颜色变量确实发生了变化。