Figma Variables 间距、尺寸与 UI 密度令牌(Spacing & Density Variables)工程化实战:4px/8px 模数阶梯、Scope 作用域隔离与多端模式切换指南
许多团队在落地 Figma Variables 变量 时,往往只把颜色(Color)做成了浅色/深色主题,而内边距(Padding)、元素间距(Gap)、组件高度与容器极限宽度依然散落在画布各处手动输入硬编码数字。结果一到“PC 宽屏切紧凑表格模式”或“桌面端转平板与移动端适配”时,设计师只能逐个页面重新拆改 Auto Layout 自动布局,研发也只能靠肉眼对照去猜间距规律。
借助 Figma 原生的 Number(REST API 中对应 FLOAT)数值变量,结合 Scope 作用域精确隔离 与 多维 Mode 正交切换,设计系统完全可以用同一套语义令牌同时驱动“空间尺度体系”与“UI 密度开关”。
一、Spacing / Sizing / Density 三层数值变量架构对比 #
与颜色令牌(详见 Variables 原生 JSON 导入导出与扩展合集实战)相同,严谨的空间尺度体系也应分为基元层、语义层与密度/断点模式层,切忌直接把像素数字暴露给业务页面。
| 层级划分 | 推荐 Collection 名称 | 典型命名规范示例 | 核心职责与复用范围 | 建议 Mode 配置 |
|---|---|---|---|---|
| 基元数值层(Primitives) | Primitives / Scale | scale/0、scale/2、scale/4、scale/8、scale/12、scale/16、scale/24、scale/32 | 锚定 4px / 8px 物理基准阶梯,包含少量 2px、6px 半步微调槽位,全局只读不直接绑定业务组件 | 单模式(Value) |
| 语义间距与尺寸层(Semantic) | Semantic / Layout | space/inset/card、space/stack/sm、space/inline/xs、size/control/md | 通过 Alias 别名引用基元值,表达“卡片内边距”“列表垂直间距”“控件基准高度”等设计意图 | 按需开启 Default / Compact / Spacious 三档密度 |
| 响应式断点层(Viewport) | Responsive / Breakpoint | layout/page-gutter、layout/section-gap、layout/container-max | 控制整页外边距、区块纵向留白与栅格容器最大宽度,随视口断点一键缩放 | Desktop_1440 / Tablet_768 / Mobile_390 |
| 组件专属微调层(Component) | Component / Density | btn/height/md、table/cell-py、input/padding-x | 仅在特定高复杂组件(如金融终端表格、工具栏)需要独立覆盖密度倍率时下沉封装 | 继承或独立覆盖 Compact / Regular |
为什么推荐把“UI 密度”与“屏幕断点”拆进两个独立 Collection?
如果你把 Desktop / Mobile 和 Compact / Spacious 塞进同一个集合,4 档断点 × 3 档密度就会产生 12 个组合 Mode,不仅超出 Professional 套餐 4 Modes 上限,维护成本也会指数级上升。将“视口断点”和“界面密度”拆分为两个正交集合后,任意页面都可以自由组合出“Desktop + Compact(后台密集表格)”或“Mobile + Spacious(长辈/触屏大热区)”。
二、实操一:搭建 4px / 8px 基元阶梯与 Scope 作用域防误绑隔离 #
很多团队建完几百个数字变量后,设计师在右侧属性面板点击圆角、描边或文本字号旁的变量图标时,会发现下拉列表里混杂着所有间距和容器宽高变量,极易误绑。解决这一痛点的关键就是严格配置 Variable Scope(作用域)。
1. 建立 Primitives / Scale 绝对数字阶梯 #
- 打开右侧面板
Local variables,新建名为Primitives / Scale的集合。 - 创建
Number类型变量,建议采用与 Tailwind CSS v4 / Design Tokens 命名规范 对齐的阶梯步长(或以像素直觉命名):- 微调半步:
scale/2(2)、scale/6(6)、scale/10(10) —— 仅用于图标与文字贴合或徽标内边距; - 主力 4px 模数:
scale/4(4)、scale/8(8)、scale/12(12)、scale/16(16)、scale/20(20)、scale/24(24)、scale/32(32)、scale/40(40)、scale/48(48)、scale/64(64)。
- 微调半步:
- 选中所有基元变量(按住
Shift批量多选),右键Edit variable,取消勾选Show in all supported properties(或仅取消全部 Scope 勾选),再勾选Hide from publishing,从源头禁止业务设计师直接把原始数字scale/16绑到业务页面,强迫团队消费语义层变量。
2. 为语义间距、尺寸与圆角变量精准分配 Scope #
新建 Semantic / Layout 集合,通过右键 Create alias 引用 Primitives / Scale,随后按用途严格限定 Scope:
| 语义变量分组 | 绑定的 Figma 属性面板位置 | 必须勾选的 Scope 选项 | 绝对禁止勾选的 Scope |
|---|---|---|---|
space/inset/*(内边距)与 space/gap/*(间距) | Auto Layout 的 Horizontal/Vertical Padding 与 Gap | 仅勾选 Gap & padding(部分版本显示为 Gap) | Width and height、Corner radius、Text |
size/control/*(控件标准高度/宽度) | 图层的 W / H 尺寸框、Min width / Max width | 仅勾选 Width and height | Gap、Stroke、Font size |
radius/*(圆角)与 border/width/*(描边粗细) | 图层 Corner radius 与 Stroke weight | 圆角仅勾选 Corner radius;边框仅勾选 Stroke | Width and height、Gap |
opacity/*(不透明度) | 图层/填充透明通道 | 仅勾选 Layer opacity | 其他所有长度属性 |
关于圆角变量的同心嵌套数学关系,可进一步阅读 Figma 圆角系统与同心圆角工程化实战;关于排版字号与行高变量,可参阅 Figma 排版变量(Typography Variables)企业级落地实战。
三、实操二:用 Mode 实现 Compact / Default / Spacious 一键密度切换 #
在 SaaS 后台、数据表格与跨终端应用中,同一套组件往往需要同时服务“桌面高信息密度作业”与“触屏宽松防误触点击”。用数字变量的 Mode 可以彻底告别维护三套重复组件变体的噩梦。
1. 配置三档密度语义矩阵 #
在 Semantic / Layout 集合中添加三个 Mode 列:Default(标准)、Compact(紧凑)、Spacious(宽松),并将同一语义令牌分别指向不同的基元 Alias:
| 语义变量名称 | Compact(高密度作业) | Default(常规基准) | Spacious(触控/宽松阅读) | 典型绑定图层位置 |
|---|---|---|---|---|
space/card/padding | scale/12 (12px) | scale/16 (16px) | scale/24 (24px) | 卡片外框 Horizontal & Vertical Padding |
space/stack/item-gap | scale/4 (4px) | scale/8 (8px) | scale/12 (12px) | 表单项标题与输入框垂直 Gap |
space/inline/control-gap | scale/6 (6px) | scale/8 (8px) | scale/12 (12px) | 按钮内部图标与文本水平 Gap |
size/control/height-md | scale/32 (32px) | scale/40 (40px) | scale/48 (48px) | 按钮、单行输入框、下拉选择框高度 H |
size/table/row-height | scale/36 (36px) | scale/48 (48px) | scale/56 (56px) | 数据表格行容器最小高度 Min H |
2. 绑定 Auto Layout 与极值约束的实操细节 #
- 绑定 Padding 与 Gap:选中具备 Auto Layout(
Shift + A)的卡片或表格行,点击Horizontal padding/Vertical padding输入框,悬浮后点击右侧六边形变量图标,选择space/card/padding。若需要上下左右不对称内边距,点击输入框旁的Individual padding图标,可分别为Top / Right / Bottom / Left绑定不同变量。 - 绑定 Min / Max 极限尺寸:将容器宽度模式切换为
Fill container或Hug contents后,展开宽度下拉菜单中的Add min width/Add max width,即可将layout/container-max绑定至极限边界。这样容器既保持响应式弹性伸缩,又能随Responsive / Breakpoint模式切换自动收紧最大栏宽。 - 整页预览一键切换:选中最外层画板或
Section,在右侧Appearance/Layer栏点击六边形Apply variable mode图标,切换Semantic / Layout -> Compact或Spacious,整页所有表单、表格行高与卡片留白会在 1 秒内无损重组。
绑定 Gap 变量会覆盖 `Space between` 的 Auto 模式
一旦为 Auto Layout 容器的间距绑定了数值变量,该容器就无法同时维持 Auto(即 CSS justify-content: space-between 两端对齐)状态。需要左右贴边自适应分布的顶栏或表头,应保持 Gap = Auto 或改用子图层 Fill container 推挤,切勿强行绑定间距变量。
四、实操三:配置多端 Code Syntax 与 Tailwind / CSS 变量零偏差交付 #
数值变量如果不填写代码语法,工程师在 Dev Mode 开发模式 中看到的依然是 padding: 16px 而不是项目里的 Token 名称(延伸实战见 Figma Variables 驱动组件变体与图层显隐实战)。
1. 为空间变量统一配置三端 Code syntax #
打开任意语义空间变量(如 space/card/padding)的编辑弹窗,滚动到底部 Code syntax 区域,分别添加各端语法:
- Web(CSS Custom Properties):
var(--space-card-padding)(或与 Tailwind CSS v4 对齐为p-card/gap-stack-sm); - iOS(SwiftUI):
DS.Spacing.cardPadding; - Android(Jetpack Compose):
AppTheme.spacing.cardPadding。
2. 前端 CSS 变量与 Tailwind v4 @theme 映射范式 #
前端仓库只需通过 GET /v1/files/:file_key/variables/published(参见 Figma Variables REST API 双向同步实战)或原生 JSON 导出,即可直接编译为与 Figma 密度模式完全一致的 CSS 变量切换开关:
/* 1. 基元与默认语义层(对应 Figma Default Mode) */
:root {
--scale-4: 4px;
--scale-8: 8px;
--scale-12: 12px;
--scale-16: 16px;
--scale-24: 24px;
--scale-32: 32px;
--scale-40: 40px;
--scale-48: 48px;
--space-card-padding: var(--scale-16);
--space-stack-item-gap: var(--scale-8);
--size-control-height-md: var(--scale-40);
}
/* 2. 紧凑模式覆盖(对应 Figma Compact Mode) */
[data-density="compact"] {
--space-card-padding: var(--scale-12);
--space-stack-item-gap: var(--scale-4);
--size-control-height-md: var(--scale-32);
}
/* 3. 宽松/适老模式覆盖(对应 Figma Spacious Mode) */
[data-density="spacious"] {
--space-card-padding: var(--scale-24);
--space-stack-item-gap: var(--scale-12);
--size-control-height-md: var(--scale-48);
}
五、Spacing & Density 变量高频踩坑排查表 #
如果在绑定或切换空间变量时遇到界面错位、Dev Mode 不显示 Token 或模式切不动的问题,可按以下清单快速定位(更多通用排障请参阅 Figma 常见报错与疑难故障诊断手册):
| 异常现象 | 底层原因定位 | 标准化排查与修复方法 |
|---|---|---|
| 下拉列表找不到刚建好的间距变量 | Scope 作用域未勾选对应属性(如只勾了 Width and height 却想绑到 Padding) | 打开该变量的 Edit variable 面板,核对并补勾 Gap & padding(或相应目标 Scope) |
| 切换密度 Mode 后按钮高度没变化 | 组件高度设为 Hug contents 且内部文字行高+上下 Padding 撑开了外框,未直接绑定 H,或被外层实例手动覆盖成固定数值 | 若需严格固定控件高度,将 H 设为 Fixed 并绑定 size/control/height-md;若由内容撑开,应改为给上下 Padding 绑定变量 |
| 外层画板切换了 Mode,内部子卡片却无动于衷 | 子组件实例被手动锁定了某一个具体 Mode(不再是 Auto 继承状态),或子卡片引用的变量属于另一个未切换的集合 | 选中子卡片,在 Apply variable mode 下拉框中将其切回 Auto(跟随父级上下文继承) |
Dev Mode 只输出 16px,不显示 var(--space-...) | 变量仅设置了名称但未填写 Code syntax,或该变量位于未发布的外部草稿库中 | 在变量编辑弹窗底部补齐 Web / iOS / Android 的 Code syntax,并将变量库执行 Publish 发布 |
绑定 Min width 后组件还是被压扁或撑破 | Auto Layout 水平方向设为了 Fixed 而非 Fill container / Hug contents,导致极限约束不生效 | 将图层缩放行为切换为 Fill 或 Hug,Figma 才会激活并尊重绑定的 Min/Max 数值变量 |
核心手册与速查工具
高频手册与实用设计生产力工具直达常见问题与答疑 (FAQ)
高频疑难解析与避坑指南完全不需要。绝大多数核心功能在免费 Starter 计划中均可完整体验与实操练习,无需额外付费购买付费团队版。