Figma Variables 驱动组件变体与图层显隐实战:String / Boolean 变量绑定变体切换、Number 间距密度与多端模式一键切换指南
绝大多数设计师使用 Variables 变量 时,只停留在“建一套浅色/深色模式颜色变量”。但只要页面里包含几十个组件实例,每当需要切换“移动端 / 桌面端控件规格”、“管理员 / 普通访客权限视图”或“标准密度 / 紧凑数据密度”时,依然只能全选实例一个一个改参数,或者被迫复制出好几套重复画板。
实际上,Figma 原生的 String(字符串)、Boolean(布尔)与 Number(数字)变量 可以直接绑定到组件实例的变体属性(Variant Property)、图层可见性(Layer Visibility)以及 Auto Layout 间距尺寸。只需在最外层页面 Frame 切换一次 Mode,整页组件形态、权限按钮显隐与排版密度就能同步自动变形。关于组件变体与属性面板的基础概念,可先参阅 创建和使用变体指南 与 组件集属性降维实战。
一、三种状态控制方案对比:什么时候该用变量驱动? #
在设计系统中,并不是所有开关都适合用全局变量接管。下表帮你划清三类机制的最佳职责边界:
| 控制机制 | 作用域与生效方式 | 最适合解决的业务场景 | 核心优势 | 主要局限与注意事项 |
|---|---|---|---|---|
手动切换组件 Variant | 针对单个选中的组件实例生效 | 同一页面内需要同时并存不同形态(如“主按钮 + 次按钮”) | 灵活自由,不依赖集合 Mode 配额 | 跨 50 个画板批量改端型/密度时维护成本极高 |
| Component Properties(组件属性) | 通过主组件向外暴露局部 Boolean / Text / Instance 开关 | 单个卡片“是否显示副标题”、“是否显示左侧图标” | 大幅抑制变体数量爆炸,属性面板直观 | 仍需在每个实例右侧单独勾选,无法跨整页一键联动 |
String / Boolean / Number Variables 绑定 | 绑定到实例属性或图层眼睛,随外层 Frame 的 Mode 一键联动 | 全局视图模式切换:紧凑/宽松密度、多角色权限态、iOS/Android 平台态、多语言文案 | 改一次顶层 Mode,整页所有组件结构与显隐瞬间全变 | 需严格对齐字符串大小写,且受方案 Modes 数量配额限制 |
核心原则:局部差异用 Properties,全局模式用 Variables
判断一条状态该交给 Component Properties 还是 Variables,只需问一个问题:“当整个页面或模块切换模式时,所有同类组件是否要一起同步变化?” 如果是(例如“切换管理员视图时所有删除按钮一起出现”),就用变量;如果同一页里有的卡片带角标、有的不带,就保留组件自身属性。
二、实操一:用 String 变量绑定组件变体,一键切换整页风格 #
通过将 String 变量绑定到实例的变体下拉框,可以让同一套组件在“桌面端 vs 移动端”或“常规密度 vs 极简紧凑”之间无损自动切换:
- 对齐主组件的
Variant属性名与可选值:- 假设你制作了一个按钮组件集
Button,其中包含一个名为Size(或Density)的变体属性,可选值为compact与regular(建议全部采用小写英文,避免空格和大小写拼写误差)。 - 在输入框、表格行
TableRow组件集中同样使用完全一致的变体值命名:compact与regular。
- 假设你制作了一个按钮组件集
- 创建
String变量合集与双模式:- 打开右侧
Local variables,新建集合Layout_Density,添加两个 Mode:Regular(常规)与Compact(紧凑)。 - 点击
+ Create variable选择String,命名为component/density:- 在
Regular列填入:regular - 在
Compact列填入:compact
- 在
- 打开右侧
- 在组件实例上绑定
String变量(关键步骤):- 从
Assets面板把Button与TableRow的**实例(Instance)**拖入页面画板(注意:必须在组件实例上绑定,不能在 Component Set 主组件定义本身上绑自己)。 - 选中画板中的
Button实例,在右侧属性面板找到Size变体下拉框。 - 将鼠标悬停在下拉框右侧空白边缘,会出现一个六边形的
Apply variable图标,点击后选择component/density。 - 验证联动:选中外层整个页面
Frame,在右侧Layer面板点击六边形Change variable mode图标,将Layout_Density从Regular切换为Compact——整页所有的按钮、输入框和表格行会同步缩成紧凑型变体!
- 从
三、实操二:用 Boolean 变量批量控制图层显隐与权限视图 #
以前要做“未登录游客态 vs 已登录会员态”或“普通员工 vs 管理员审核态”两套界面,设计师往往要把整页复制一份然后手动删掉几个按钮。借助 Boolean 变量绑定图层显隐,一份画稿即可实时演练多角色界面:
- 建立角色权限
Boolean变量集合:- 新建集合
User_Role,设立两个 Mode:Viewer(普通成员)与Admin(管理员)。 - 创建两个
Boolean类型变量:role/canDelete:Viewer设为false,Admin设为true。role/showAuditLog:Viewer设为false,Admin设为true。
- 新建集合
- 绑定到普通图层或组件布尔属性:
- 方法 A(直接绑定画布图层显隐):选中列表页里的“批量删除”按钮或“管理后台入口”卡片,把鼠标移到右侧
Appearance(或Layer)面板的眼睛图标上,右键单击眼睛图标(或点击悬浮出现的变量小图标),直接选择role/canDelete。当 Mode 为Viewer时,该按钮在画布与 Auto Layout 占位流中自动隐藏,右侧空间立即自然收紧。 - 方法 B(绑定到组件的 Boolean Property):如果
TableRow主组件本身暴露了一个名为Show Actions的布尔开关属性,选中实例后悬停该开关右侧,点击六边形图标同样可绑定role/canDelete。
- 方法 A(直接绑定画布图层显隐):选中列表页里的“批量删除”按钮或“管理后台入口”卡片,把鼠标移到右侧
四、实操三:Number 变量驱动间距密度与 Scopes 防污染治理 #
把上述变体切换与显隐控制再配合 Number 变量,就能形成真正全自动的响应式密度系统:
- 参数化布局尺寸:
- 在
Layout_Density集合中补充Number变量:space/cardGap(Regular: 16,Compact: 8)、space/cardPadding(Regular: 24,Compact: 12)、radius/card(Regular: 12,Compact: 6)。 - 将卡片父级 Auto Layout 的
Gap、Padding与Corner radius分别绑定到这三个变量。
- 在
- 严格配置
Scopes作用域防误选:- 在
Local variables编辑space/cardGap时,务必取消勾选All properties,仅勾选Gap and padding;radius/card仅勾选Corner radius(作用域深度治理详见 Variables 作用域与私有 Token 架构实战)。这样在调整文字字号或描边粗细时,下拉菜单不会被几十个间距数字淹没。
- 在
- 配合 Mode 配额做正交拆分:
- 若账号处于 Starter(1 Mode)或 Pro(4 Modes)限制,避免把“主题颜色 + 密度 + 角色”全塞在同一个集合里,应拆分为独立小集合正交组合(具体拆法参见 Variables 模式配额破局实战)。
五、Variables 绑定变体与显隐高频故障排查表 #
在实操过程中如果发现绑定按钮找不到、切换 Mode 没反应或图层显隐异常,可按以下清单排查修复(更多故障参见 Figma 常见报错与疑难故障诊断手册):
| 异常现象 | 底层原因定位 | 标准化排查与修复方案 |
|---|---|---|
悬停组件变体下拉框时,根本看不到六边形 Apply variable 图标 | 当前选中的是**主组件(Main Component / Component Set)**内部,或该属性不是 Variant / Boolean / Text 类型 | 退回到使用该组件的**实例(Instance)**上悬停绑定;若要在组件内部子图层绑定,请先检查变量是否已创建对应的 String 或 Boolean 类型 |
切换了外层 Frame 的 Mode,实例变体却死活不变或报错回退默认态 | String 变量填入的值与组件集里定义的 Variant 选项值大小写不一致(例如变量填 "Compact",变体名是 "compact") | 核对主组件变体值拼写与 Local variables 字符串完全一致(区分大小写且去除前后多余空格) |
| 对普通图层右键“眼睛图标”却没有弹出绑定变量菜单 | 新建的集合里没有任何 Boolean 类型的变量,或操作点偏离到了图层锁图标上 | 先在 Local variables 创建一个 Boolean 变量,再回到画布选中目标图层,右键单击 Appearance 面板右侧的眼睛图标即可看到变量列表 |
| 外层画板切换 Mode 后,页面里一半组件变了,另一半毫无反应 | 没反应的那部分组件曾被手动显式指定了某个固定 Mode,覆盖了从父级继承的 Auto 状态 | 选中失效的局部卡片或实例,在右侧 Layer 面板点击 Mode 图标将其恢复为 Auto (Inherit) |
用 Boolean 变量隐藏某子元素后,父级容器高度没有自动收起留下一块空白 | 外层容器未使用 Auto Layout,或容器高度被写死为 Fixed height | 为父级添加 Auto Layout(⇧ + A) 并将垂直尺寸设为 Hug contents,隐藏元素即可自动让出占位空间 |
核心手册与速查工具
高频手册与实用设计生产力工具直达常见问题与答疑 (FAQ)
高频疑难解析与避坑指南完全不需要。绝大多数核心功能在免费 Starter 计划中均可完整体验与实操练习,无需额外付费购买付费团队版。