HTML / CSS / 系统课时

理解设计令牌

理解设计令牌

设计令牌把颜色、字号、间距和圆角从具体组件中抽离出来,为整个界面提供统一命名。完成本课后,你将能用 Tailwind 的主题变量建立基础令牌与语义令牌,并让组件在主题变化时自动获得一致的新样式。

学习目标

  • 区分基础令牌、语义令牌和组件用法。
  • 在 Tailwind 主题中声明可生成工具类的令牌。
  • 使用语义颜色支持明亮与暗色主题切换。

设计令牌解决什么问题

直接在组件中反复写 #2563eb、24px 或 16px,短期很快,长期却难以统一修改。设计令牌用稳定名称代替具体值,例如 brand-600 表示品牌色阶,surface 表示页面表面,page 表示页面留白。调整令牌后,引用它的组件会一起变化。

令牌通常分三层:基础令牌保存原始色阶和尺寸;语义令牌描述用途,如背景、正文、危险状态;组件通过工具类消费语义令牌。组件应优先依赖用途名称,而不是绑定某个色值,否则暗色主题或品牌换肤时仍要逐个修改。

设计令牌分层与传播关系图

声明基础与语义令牌

下面的 CSS 先定义会生成 Tailwind 工具类的尺寸令牌,再通过普通 CSS 变量保存明暗主题的语义颜色。@theme inline 把语义变量映射为 bg-surface、text-content 和 bg-primary 等工具类。

css
@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 不需要修改。

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>

预期结果

text
明亮主题:卡片为浅色表面、深色正文和 brand-600 主按钮。
根元素添加 dark:表面、正文、次要文字和主按钮自动切换到暗色主题值。
修改 spacing-page、radius-card 或 font-size-title:所有引用对应工具类的组件同步更新。

命名与维护边界

令牌名称应描述角色而不是临时页面位置。primary、surface、content-muted 比 home-blue、left-card-gray 更容易复用。基础色阶可以保留数字层级,语义层则应保持稳定,以便不同主题映射到不同基础值。

不要为每个细微差异都创建新令牌。只有会被多处复用、需要统一调整或承担明确语义的值才值得抽象。单个实验组件的特殊尺寸可以先使用现有尺度,确认复用需求后再提升为全局令牌。

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

目录与阅读设置

阅读设置

17

记录一个想法

理解设计令牌

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

登录哪都通