UI 视觉设计 / 系统课时

建立 Collection 与变量分组

建立 Collection 与变量分组

把基础颜色、语义颜色和组件专用值混放在 Figma 的同一个变量列表中,会让主题切换、变量复用和源文件同步变得困难。本课将创建三个职责明确的 Collection,使用 Group 组织变量,并通过跨集合别名验证引用关系,最终形成可与 Design Token 源文件逐项对应的变量结构。

学习目标

  • 区分 Collection、Group 和 Variable 的职责,确定基础层、语义层及组件层的组织边界。
  • 在 Figma 中创建集合与嵌套分组,完成变量命名和跨集合别名设置。
  • 建立 Figma 变量与 Token 源文件的路径映射,并验证变量修改能够正确传递。

按模式和维护职责划分 Collection

Figma 的 Collection 是变量及其 Mode 的管理容器,Group 则用于在集合内部组织变量。Collection 不只是文件夹:同一 Collection 中的变量共享一组 Mode,因此是否需要一起切换主题,是划分集合的重要依据。

以一个支持品牌蓝色、浅色界面和按钮组件的设计系统为例,可以先采用以下方案:

Collection 维护内容 示例变量 Mode 规划
Primitives 原始颜色、间距和圆角刻度 color/brand/600、space/4 Default
Semantic 页面表面、文字和交互用途 color/surface/default、color/action/primary Light、Dark(按需)
Components 组件特有的设计决策 button/primary/background Default,优先引用语义变量

例如,color/brand/600 的值为 #2563EB,表示一个基础色值;color/action/primary 表示主要交互操作所使用的颜色;button/primary/background 则表示主按钮背景。后两者可以通过 Alias 引用上游变量,而不必分别复制 #2563EB。

划分集合时可使用两个判断标准:

  1. 变量是否需要共享同一组 Mode?如果页面表面色和文字色都必须随 Light、Dark 切换,宜放在同一个 Semantic 集合。
  2. 变量是否具有独立的维护责任?若大量按钮、输入框和导航组件具有专用 Token,可建立 Components 集合;只有少量组件变量时,也可以先放入 Semantic,避免过度拆分。

在 Variables 面板创建集合和分组

以下路径适用于 Figma Design 当前采用独立 Variables 视图的界面。较旧版本可能需要先取消画布选择,再从右侧 Local variables 进入变量面板;操作时应以实际显示的菜单名称为准。

  1. 打开具有编辑权限的 Figma 设计文件,从左侧导航栏选择 Variables,进入变量管理视图。
  2. 如果文件没有任何变量,先使用 Create variable 新建一个 Color 变量,将其命名为 color/brand/600,值设为 #2563EB。Figma 会根据斜杠路径组织变量分组。
  3. 在变量视图侧边栏选择 More options,使用 Create collection 创建新集合。将初始集合整理或重命名为 Primitives,再建立 Semantic 和 Components。
  4. 在 Primitives 中继续添加 Color 变量 color/neutral/0,值为 #FFFFFF;添加 Number 变量 space/4,值为 16,作为 16 像素的基础间距刻度。
  5. 切换到 Semantic,新增 color/action/primary 和 color/surface/default 两个 Color 变量;再切换到 Components,新增 button/primary/background。
  6. 如需整理已有变量,使用 Windows 的 Ctrl 或 macOS 的 Command 多选变量,右键执行 New group with selection。也可以拖动侧边栏中的 Group 调整顺序或嵌套层级。

Figma Variables 视图中的集合与变量分组操作位置

Figma 变量名称中的 / 用于建立分组层级。例如,color/brand/600 在 Primitives 集合中形成 color、brand 两级 Group,末端变量名为 600。Group 可以嵌套,但不独立拥有 Mode;Mode 始终属于 Collection。

建议变量名称统一使用小写英文、数字与斜杠,语义名称采用用途而非具体色值,如 color/text/primary,不要把语义变量命名为 color/blue/primary。否则品牌色变更后,名称仍然包含旧颜色含义。

连接别名并对齐 Token 文件路径

完成分组后,需要建立实际的引用关系,而不是仅创建名称相似、数值相同的变量。以主按钮背景为例,按以下顺序设置:

  1. 在 Semantic 集合中找到 color/action/primary,右键点击其值单元格,选择 Create alias,从变量选择器中找到 Primitives 的 color/brand/600。
  2. 在 Components 集合中找到 button/primary/background,同样选择 Create alias,引用 Semantic 的 color/action/primary。
  3. 返回 Semantic,将 color/surface/default 引用到 Primitives 的 color/neutral/0。
  4. 检查所有别名的目标类型:Color 变量应引用 Color 变量,不能将 Number 类型的 space/4 当作颜色来源。

此时主按钮背景经过两级别名解析,最终得到 #2563EB。三个 Collection 负责不同的管理边界,Group 则负责各自集合内部的路径组织。

为了与 DTCG 风格的 JSON Token 源文件对齐,可以约定下列映射表:

Figma Collection Figma 变量名 源文件 JSON 节点路径
Primitives color/brand/600 tokens/primitives/color.tokens.json color.brand.600
Semantic color/action/primary tokens/semantic/color.tokens.json color.action.primary
Components button/primary/background tokens/components/button.tokens.json button.primary.background

这里的点号表示 JSON 对象的嵌套路径,不是要求在 JSON 中创建带点号的单个键。以第一行为例,应依次进入 color、brand、600,在最终 Token 节点上保存 $type 和 $value 等字段。

三层 Figma Collection 别名链与源文件映射关系

验证变量结构和引用是否正确

不要只检查变量列表是否整齐,还应在画布中检查绑定和更新是否真的生效。

  1. 在画布中绘制一个矩形,作为主按钮背景,在 Fill 属性中选择绑定变量,指定 Components 集合的 button/primary/background。预期填充颜色为 #2563EB。
  2. 返回 Primitives,将 color/brand/600 临时修改为 #1D4ED8。如果别名链正确,画布上的矩形应同步显示新颜色,不需要重新绑定 Fill。
  3. 使用撤销将原始颜色恢复为 #2563EB,再次检查矩形显示和变量绑定。
  4. 分别打开三个 Collection,确认 Group 路径与映射表一致,不存在诸如 color/color/brand/600 的重复前缀,也没有同一用途的多个独立色值副本。

如果按钮颜色没有更新,先检查 Fill 是否实际绑定变量而不是直接填入十六进制色值,再检查两个 Alias 是否仍指向预期目标。若变量在选择器中找不到,可从变量的 Edit variable 中检查 Scope,确认该变量允许用于相应的填充属性。

如果准备将变量发布给其他设计文件使用,还应检查隐藏发布设置,避免把仅供内部引用的基础变量与面向组件使用者的语义变量全部暴露在同一选择层级中。

本次完成的验收结果应是三个职责明确的 Collection、可追踪的 Group 命名路径、一条能够随上游色值变化的别名链,以及与三份 Token 源文件一一对应的路径映射表。后续调整主题或生成代码时,就可以沿这些关系定位变量来源,而不必逐个组件查找硬编码颜色。

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

目录与阅读设置

阅读设置

17

记录一个想法

建立 Collection 与变量分组

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

登录哪都通