UI 视觉设计 / 系统课时

用变体和属性表达组件状态

用变体和属性表达组件状态

本课将按钮和输入框整理成可复用的 Figma 组件:用 Variant 表达不同的视觉状态,用 Boolean 控制可选图层,用 Instance Swap 更换嵌套图标。完成后,设计师可以直接在实例属性面板中调整状态和内容,不必复制大量组件或拆离实例。

学习目标

  • 区分 Variant、Boolean 与 Instance Swap 的适用场景。
  • 建立具有尺寸、样式和交互状态的 Button 组件集,并复用图标属性。
  • 检查输入框的组合状态,避免重复变体和无效配置。

先确定哪些差异值得做成变体

Variant(变体)适合改变组件整体外观的离散选择;Boolean(布尔属性)适合控制图层显隐;Instance Swap(实例替换属性)适合替换嵌套的组件实例。三者不应互相替代。

变化 推荐属性 Button 示例
语义与样式 Variant Type=Primary/Secondary
尺寸 Variant Size=Small/Medium
交互外观 Variant State=Default/Hover/Pressed/Disabled
是否显示前置图标 Boolean Show leading icon=false/true
前置图标的种类 Instance Swap Leading icon=plus/search/download

前三个维度理论上有 2 × 2 × 4 = 16 种组合。如果再把图标显隐的 2 种取值和 8 个图标都做成 Variant,组合数量会扩张到 16 × 2 × 8 = 256,其中很多组合并无实际意义。

改用 Boolean 和 Instance Swap 后,按钮最多只需管理 16 个基础外观变体。Figma 不要求补齐所有理论组合,应只创建产品真正需要的状态。

Button 变体与组件属性的职责分工

创建 Button 的变体集合

以下操作适用于 Figma Design 的组件属性工作流。以主按钮为例,先建立基础结构,再添加状态,能够避免不同变体出现图层名称和布局结构不一致的问题。

  1. 绘制一个横向 Auto layout 按钮,命名为 Button。Medium 规格采用高度 40 px、左右内边距 16 px、图标与文字间距 8 px、圆角 8 px;示例背景为 #2563EB、文字为 #FFFFFF。
  2. 选中按钮,Windows 按 Ctrl+Alt+K,macOS 按 Option+Command+K,创建主组件。
  3. 通过右键菜单 Main component > Add variant 添加变体。也可以复制已有主组件后多选,在右侧点击 Combine as variants。组件集形成后,将默认的 Variant、Property 2 等属性名改为 Type、Size、State,设置对应取值。
  4. 为需要交付的组合建立唯一变体。Small 高度改为 32 px、左右内边距改为 12 px;Primary 的 Default、Hover、Pressed 背景分别使用 #2563EB、#1D4ED8、#1E40AF。Disabled 使用单独的禁用样式,不建议仅靠降低整个组件的不透明度处理。
  5. 将最常用的 Primary / Medium / Default 变体放到组件集左上角。Figma 使用左上角变体作为组件集的默认变体。

为图标绑定 Boolean 和 Instance Swap

按钮的前置图标有两个独立问题:是否显示,以及显示哪一个图标。将它们拆成两个属性,才能避免为每个图标复制整套按钮变体。

  1. 先准备 Icon/plus、Icon/search、Icon/download 等图标主组件。在各个 Button 变体内部放置 Icon/plus 的组件实例,而不是普通矢量路径。
  2. 选中嵌套图标,在右侧 Appearance 区找到 Apply variable/property,创建 Boolean 属性,命名为 Show leading icon,默认值为 false,并绑定到图标图层的可见性。其余变体复用同一个属性。
  3. 再选中图标实例,在右侧使用 Create instance swap property 或对应的实例替换属性入口,创建 Leading icon,默认值为 Icon/plus。
  4. 在 Preferred instances 中加入 Icon/search 和 Icon/download。这样实例替换菜单会优先提供设计系统允许的图标。
  5. 从 Assets 面板拖出 Button 实例,将 Show leading icon 打开,再把 Leading icon 切换为搜索图标。关闭开关时应只隐藏图标,而不清除当前图标的选择。

Boolean 组件属性只负责图层可见性,不会自动禁止点击。按钮 Disabled 外观与前端 disabled 行为仍需分别定义。需要修改按钮文字时,可给文字层添加 Text 属性,无需为“保存”“提交”等文案分别建立变体。

输入框用独立维度表达焦点与错误

输入框可能同时处于聚焦和校验失败状态,因此不宜将 Focused 与 Error 简单放进同一组互斥状态。

可以将 Interaction=Idle/Focused/Disabled 与 Validation=None/Error 设为两组 Variant 属性。理论组合数为 3 × 2 = 6,但实际只需要创建有明确使用场景的组合。

组合 可检查的呈现要求
Focused + None 显示 2 px 焦点描边,无错误信息
Idle + Error 错误描边与错误提示同时可见
Focused + Error 保留可辨识的焦点提示,同时呈现错误
Disabled + None 采用禁用外观,不显示可编辑焦点

是否创建 Disabled + Error,应先由产品交互规范决定,不必为了凑满六种组合而创建无效状态。

如果输入框有可选的搜索图标,继续使用 Boolean 和 Instance Swap;如果占位文案需要变化,可使用 Text 属性。校验错误文本也可以通过 Text 属性编辑,但错误信息何时出现、如何隐藏,必须另外明确规定。

用实例验证组件属性与交付质量

在独立测试画板中,从 Assets 面板拖入 Button 和输入框实例,操作右侧 Properties,检查实际效果,而不是只检查主组件画板。

  1. Primary / Medium / Default 应显示预期的初始外观。切换到 Secondary / Small / Disabled 后,不应保留旧颜色或出现布局错位。
  2. 连续切换三种图标,并打开、关闭 Show leading icon。图标隐藏后,Auto layout 应收回对应的图文间距,而不是留下空白占位。
  3. 输入框切换到 Focused + Error 时,应同时辨识焦点与错误;不同的外观组合不能使用完全相同的 Variant 属性值。
  4. 检查属性名称、默认值和允许的图标列表是否符合交付规范;修改实例不应要求执行 Detach instance。
  5. 确认组件通过检查后,再将主组件发布到团队库。发布共享组件需要相应的 Figma 方案及权限。

界面入口和属性行为可对照Figma 官方组件属性说明。如果新增一种按钮图标只需要扩展 Preferred instances,而不必复制全部按钮状态变体,就说明这套属性划分有效控制了组件库的组合规模。

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

目录与阅读设置

阅读设置

17

记录一个想法

用变体和属性表达组件状态

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

登录哪都通