HTML / CSS / 系统课时
理解设计令牌
理解设计令牌
设计令牌把颜色、字号、间距和圆角从具体组件中抽离出来,为整个界面提供统一命名。完成本课后,你将能用 Tailwind 的主题变量建立基础令牌与语义令牌,并让组件在主题变化时自动获得一致的新样式。
学习目标
- 区分基础令牌、语义令牌和组件用法。
- 在 Tailwind 主题中声明可生成工具类的令牌。
- 使用语义颜色支持明亮与暗色主题切换。
设计令牌解决什么问题
直接在组件中反复写 #2563eb、24px 或 16px,短期很快,长期却难以统一修改。设计令牌用稳定名称代替具体值,例如 brand-600 表示品牌色阶,surface 表示页面表面,page 表示页面留白。调整令牌后,引用它的组件会一起变化。
令牌通常分三层:基础令牌保存原始色阶和尺寸;语义令牌描述用途,如背景、正文、危险状态;组件通过工具类消费语义令牌。组件应优先依赖用途名称,而不是绑定某个色值,否则暗色主题或品牌换肤时仍要逐个修改。

声明基础与语义令牌
下面的 CSS 先定义会生成 Tailwind 工具类的尺寸令牌,再通过普通 CSS 变量保存明暗主题的语义颜色。@theme inline 把语义变量映射为 bg-surface、text-content 和 bg-primary 等工具类。
@import "tailwindcss";
@theme {
--color-brand-600: #2563eb;
--color-brand-500: #3b82f6;
--font-size-title: 2rem;
--spacing-page: 1.5rem;
--radius-card: 1rem;
}
:root {
--app-surface: #ffffff;
--app-content: #0f172a;
--app-muted: #475569;
--app-primary: var(--color-brand-600);
}
.dark {
--app-surface: #0f172a;
--app-content: #f8fafc;
--app-muted: #cbd5e1;
--app-primary: var(--color-brand-500);
}
@theme inline {
--color-surface: var(--app-surface);
--color-content: var(--app-content);
--color-muted: var(--app-muted);
--color-primary: var(--app-primary);
}生效行为如下:--spacing-page 生成可用于内外边距和间距的 page 尺度,--radius-card 生成 rounded-card,--font-size-title 生成 text-title;语义颜色则在 .dark 出现时改变具体值,而工具类名称保持不变。
在组件中消费令牌
组件只引用令牌,不重复写色值和尺寸。下面的卡片同时使用页面间距、卡片圆角、标题字号与语义颜色,因此品牌色或主题值改变时,HTML 不需要修改。
<article class="mx-auto max-w-xl rounded-card bg-surface p-page text-content shadow-sm">
<p class="text-sm font-medium text-primary">Tailwind CSS</p>
<h1 class="mt-2 text-title font-semibold">统一的设计语言</h1>
<p class="mt-3 text-muted">
组件依赖语义令牌,而不是散落的十六进制颜色和任意尺寸。
</p>
<button class="mt-5 rounded-card bg-primary px-4 py-2 font-medium text-white">
开始学习
</button>
</article>预期结果
明亮主题:卡片为浅色表面、深色正文和 brand-600 主按钮。
根元素添加 dark:表面、正文、次要文字和主按钮自动切换到暗色主题值。
修改 spacing-page、radius-card 或 font-size-title:所有引用对应工具类的组件同步更新。命名与维护边界
令牌名称应描述角色而不是临时页面位置。primary、surface、content-muted 比 home-blue、left-card-gray 更容易复用。基础色阶可以保留数字层级,语义层则应保持稳定,以便不同主题映射到不同基础值。
不要为每个细微差异都创建新令牌。只有会被多处复用、需要统一调整或承担明确语义的值才值得抽象。单个实验组件的特殊尺寸可以先使用现有尺度,确认复用需求后再提升为全局令牌。