Figma Variables 驱动组件变体与图层显隐实战:String / Boolean 变量绑定变体切换、Number 间距密度与多端模式一键切换指南

2026 年 11 月 20 日

绝大多数设计师使用 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 极简紧凑”之间无损自动切换:

  1. 对齐主组件的 Variant 属性名与可选值:
    • 假设你制作了一个按钮组件集 Button,其中包含一个名为 Size(或 Density)的变体属性,可选值为 compact 与 regular(建议全部采用小写英文,避免空格和大小写拼写误差)。
    • 在输入框、表格行 TableRow 组件集中同样使用完全一致的变体值命名:compact 与 regular。
  2. 创建 String 变量合集与双模式:
    • 打开右侧 Local variables,新建集合 Layout_Density,添加两个 Mode:Regular(常规) 与 Compact(紧凑)。
    • 点击 + Create variable 选择 String,命名为 component/density:
      • 在 Regular 列填入:regular
      • 在 Compact 列填入:compact
  3. 在组件实例上绑定 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 变量绑定图层显隐,一份画稿即可实时演练多角色界面:

  1. 建立角色权限 Boolean 变量集合:
    • 新建集合 User_Role,设立两个 Mode:Viewer(普通成员) 与 Admin(管理员)。
    • 创建两个 Boolean 类型变量:
      • role/canDelete:Viewer 设为 false,Admin 设为 true。
      • role/showAuditLog:Viewer 设为 false,Admin 设为 true。
  2. 绑定到普通图层或组件布尔属性:
    • 方法 A(直接绑定画布图层显隐):选中列表页里的“批量删除”按钮或“管理后台入口”卡片,把鼠标移到右侧 Appearance(或 Layer)面板的眼睛图标上,右键单击眼睛图标(或点击悬浮出现的变量小图标),直接选择 role/canDelete。当 Mode 为 Viewer 时,该按钮在画布与 Auto Layout 占位流中自动隐藏,右侧空间立即自然收紧。
    • 方法 B(绑定到组件的 Boolean Property):如果 TableRow 主组件本身暴露了一个名为 Show Actions 的布尔开关属性,选中实例后悬停该开关右侧,点击六边形图标同样可绑定 role/canDelete。

四、实操三:Number 变量驱动间距密度与 Scopes 防污染治理 #

把上述变体切换与显隐控制再配合 Number 变量,就能形成真正全自动的响应式密度系统:

  1. 参数化布局尺寸:
    • 在 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 分别绑定到这三个变量。
  2. 严格配置 Scopes 作用域防误选:
    • 在 Local variables 编辑 space/cardGap 时,务必取消勾选 All properties,仅勾选 Gap and padding;radius/card 仅勾选 Corner radius(作用域深度治理详见 Variables 作用域与私有 Token 架构实战)。这样在调整文字字号或描边粗细时,下拉菜单不会被几十个间距数字淹没。
  3. 配合 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)

高频疑难解析与避坑指南
A

完全不需要。绝大多数核心功能在免费 Starter 计划中均可完整体验与实操练习,无需额外付费购买付费团队版。