在真实项目中,品牌色、字号、间距等设计令牌(Design Tokens)往往需要在成百上千个组件中复用,一旦设计改版,逐个查找替换简直是噩梦。CSS 变量(Custom Properties)的出现,彻底改变了这一局面。今天,我们将学习如何用 CSS 变量构建一套可扩展的样式系统,并亲手实现一个优雅的主题切换功能。
一、什么是 CSS 变量?
CSS 变量,正式名称为"自定义属性"(Custom Properties),允许你在 CSS 中声明一个具名的值,然后在整个样式表中引用它。
基本语法:
/* 1. 声明变量(必须以 -- 开头) */
:root {
--primary-color: #3b82f6;
--font-size-base: 16px;
--spacing-md: 16px;
}
/* 2. 使用变量(通过 var() 函数) */
.button {
background-color: var(--primary-color);
font-size: var(--font-size-base);
padding: var(--spacing-md);
}
:root 伪类 :它指向文档的根元素(即 <html>),在这里声明的变量具有全局作用域,可以在任何地方被引用。
二、CSS 变量的核心优势
与 Sass/Less 等预处理器的变量相比,CSS 原生变量有几个不可替代的优势:
-
运行时可变:预处理器变量在编译后就消失了,而 CSS 变量存在于浏览器运行时,可以通过 JavaScript 动态修改,甚至可以通过媒体查询或用户交互实时切换。
-
级联继承:CSS 变量遵循 CSS 的级联规则。你可以在父元素上重新定义一个变量,子元素会自动继承新值,这为实现局部主题覆盖提供了天然支持。
-
可被 JavaScript 读写 :通过
getComputedStyle()和setProperty(),你可以轻松实现 JS 与 CSS 的双向通信。 -
支持回退值 :
var()函数接受第二个参数作为回退值,当变量未定义时使用:color: var(--text-color, #333); /* 如果 --text-color 未定义,则使用 #333 */
三、实战:构建一套设计令牌系统
在开始写组件样式之前,我们先建立一套完整的设计令牌(Design Tokens)。这是现代前端工程中"设计系统化"的核心实践。
:root {
/* ===== 颜色系统 ===== */
--color-primary: #3b82f6;
--color-primary-hover: #2563eb;
--color-secondary: #6b7280;
--color-success: #10b981;
--color-warning: #f59e0b;
--color-danger: #ef4444;
/* 中性色阶 */
--color-gray-50: #f9fafb;
--color-gray-100: #f3f4f6;
--color-gray-200: #e5e7eb;
--color-gray-300: #d1d5db;
--color-gray-500: #6b7280;
--color-gray-700: #374151;
--color-gray-900: #111827;
/* 语义化颜色 */
--color-bg: #ffffff;
--color-surface: var(--color-gray-50);
--color-text: var(--color-gray-900);
--color-text-secondary: var(--color-gray-500);
--color-border: var(--color-gray-200);
/* ===== 字体系统 ===== */
--font-family-base: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
--font-family-mono: "Fira Code", "Cascadia Code", monospace;
--font-size-xs: 12px;
--font-size-sm: 14px;
--font-size-base: 16px;
--font-size-lg: 18px;
--font-size-xl: 24px;
--font-size-2xl: 32px;
/* ===== 间距系统(基于 4px 网格) ===== */
--spacing-1: 4px;
--spacing-2: 8px;
--spacing-3: 12px;
--spacing-4: 16px;
--spacing-6: 24px;
--spacing-8: 32px;
--spacing-12: 48px;
/* ===== 圆角系统 ===== */
--radius-sm: 4px;
--radius-md: 8px;
--radius-lg: 12px;
--radius-full: 9999px;
/* ===== 阴影系统 ===== */
--shadow-sm: 0 1px 2px rgba(0, 0, 0, 0.05);
--shadow-md: 0 4px 6px rgba(0, 0, 0, 0.1);
--shadow-lg: 0 10px 15px rgba(0, 0, 0, 0.1);
}
有了这套令牌,你的组件样式将变得极其简洁且一致:
.card {
background: var(--color-bg);
border: 1px solid var(--color-border);
border-radius: var(--radius-md);
box-shadow: var(--shadow-sm);
padding: var(--spacing-6);
}
.card__title {
font-size: var(--font-size-xl);
color: var(--color-text);
margin-bottom: var(--spacing-3);
}
.card__body {
font-size: var(--font-size-base);
color: var(--color-text-secondary);
line-height: 1.6;
}
四、主题切换:一行代码实现暗黑模式
CSS 变量的级联特性让主题切换变得异常简单。我们只需要在不同的选择器下重新定义同一组变量即可。
方案一:通过类名切换
/* 暗黑模式下的变量覆盖 */
[data-theme="dark"] {
--color-bg: #111827;
--color-surface: #1f2937;
--color-text: #f9fafb;
--color-text-secondary: #9ca3af;
--color-border: #374151;
--shadow-sm: 0 1px 2px rgba(0, 0, 0, 0.3);
}
配合一段极简的 JavaScript:
const toggleBtn = document.querySelector('#theme-toggle');
toggleBtn.addEventListener('click', () => {
const current = document.documentElement.getAttribute('data-theme');
document.documentElement.setAttribute('data-theme', current === 'dark' ? 'light' : 'dark');
});
方案二:跟随系统偏好
如果你希望网页自动适配用户的系统主题偏好,可以结合媒体查询:
@media (prefers-color-scheme: dark) {
:root {
--color-bg: #111827;
--color-surface: #1f2937;
--color-text: #f9fafb;
--color-text-secondary: #9ca3af;
--color-border: #374151;
}
}
方案三:多主题支持
由于变量可以被任意覆盖,你可以轻松支持无限多个主题:
[data-theme="ocean"] {
--color-primary: #0ea5e9;
--color-primary-hover: #0284c7;
--color-bg: #f0f9ff;
}
[data-theme="forest"] {
--color-primary: #22c55e;
--color-primary-hover: #16a34a;
--color-bg: #f0fdf4;
}
五、高级技巧与最佳实践
-
变量命名规范 采用
--namespace-property-modifier的命名约定,例如--color-primary-hover、--spacing-card-inner。清晰的命名能让变量自文档化。 -
语义化 vs 字面化 优先使用语义化的变量名(如
--color-text)而非字面化的(如--color-gray-900)。这样当设计改版时,你只需更改变量的值,而无需修改所有引用处。 -
局部覆盖 利用 CSS 变量的继承特性,可以在组件级别覆盖全局变量,实现局部主题:
.alert--warning { --alert-bg: var(--color-warning); --alert-text: #fff; background: var(--alert-bg); color: var(--alert-text); } -
性能优化 CSS 变量本身几乎没有性能开销。但要注意,修改变量会触发重排/重绘,避免在动画中频繁修改影响布局的变量(如
--width、--margin)。优先修改颜色和透明度等不影响布局的属性。 -
兼容性兜底 CSS 变量在现代浏览器中支持良好(Chrome 49+、Firefox 31+、Safari 9.1+),但不支持 IE。如果需要兼容 IE,可以使用 PostCSS 插件(如
postcss-custom-properties)在编译时将变量替换为静态值作为兜底。
六、与预处理器的协同
CSS 变量并不取代 Sass/Less,两者可以协同工作:
// Sass 变量用于编译时计算
$base-spacing: 4px;
:root {
// CSS 变量用于运行时切换
--spacing-1: #{$base-spacing};
--spacing-2: #{$base-spacing * 2};
--spacing-3: #{$base-spacing * 3};
}
Sass 负责数学计算、嵌套、Mixin 等编译时能力,CSS 变量负责运行时动态性。各取所长,相得益彰。
结语: CSS 变量不仅仅是一个语法糖,它是构建现代、可维护、可扩展样式系统的基石。通过设计令牌系统,你将设计决策从分散的样式规则中抽离出来,集中管理、全局复用。而主题切换功能的实现,更是让你体验到 CSS 变量在运行时的强大威力。