UI 视觉设计 / 系统课时
用属性矩阵收敛尺寸与变体
用属性矩阵收敛尺寸与变体
同一个 Button 如果允许尺寸、外观和语义色任意组合,很快就会出现没人使用的变体,以及设计稿与代码参数不一致的问题。这里以按钮为例,先限定属性职责,再用允许组合矩阵淘汰无效规格,最终得到可交付、可检查的组件契约。
学习目标
- 区分
size、variant、tone与交互状态各自负责的变化。 - 计算属性组合数量,列出允许与禁止的搭配。
- 让 Figma 组件属性与前端参数逐项对应,并验证新增需求。
确定三个互不重叠的属性
先固定属性所回答的问题。同一视觉差异只应由一个属性控制,不能同时出现 variant=primary 和 tone=brand 这样的重复表达。
| 属性 | 允许值 | 只负责什么 |
|---|---|---|
size |
sm、md、lg |
按钮可视高度 32、40、48px,并联动内边距和字号 |
variant |
solid、outline、ghost |
实心填充、描边、无外框的强调方式 |
tone |
brand、neutral、danger |
品牌操作、普通操作、破坏性操作的语义色 |
例如“删除”通常是 tone=danger,但它既可以是确认弹窗中的 solid,也可以是列表尾部的 ghost。不要额外创建 variant=delete。触控场景中即使使用 32px 的小号视觉高度,也应通过外围点击区域满足项目规定的触控尺寸;本例以至少 44×44px 为验收目标。
交互态 default、hover、pressed、focus、disabled 单独定义状态规范;它们不应与尺寸、外观、语义色混写成几十个命名字符串。
用允许矩阵删除无效组合
本项目约定:brand 用在较明确的品牌操作上,低强调的 ghost 只开放 neutral 和 danger。这是一条产品级约束,不是所有设计系统的通用限制。
| 外观与语义色 | brand |
neutral |
danger |
|---|---|---|---|
solid |
允许 | 允许 | 允许 |
outline |
允许 | 允许 | 允许 |
ghost |
禁止 | 允许 | 允许 |
如果不设限制,候选数为 3 种尺寸 × 3 种外观 × 3 种语义色 = 27;矩阵仅保留 8 组外观与语义色的配对,再乘 3 种尺寸,得到 24 组合法规格。ghost + brand 在三个尺寸下都不建立实例。

把矩阵作为组件收录规则:设计库只制作这 24 组合法组合,文档列出唯一禁止的外观与语义色配对;开发接口也必须拒绝这组值,不能只靠设计师记忆。
用页面实例检查覆盖率
从真实页面回填需求,而不是先制造所有能想象的变体。下面四种按钮用途应直接落到同一套属性。
| 页面用途 | size |
variant |
tone |
|---|---|---|---|
| 订单页提交 | lg |
solid |
brand |
| 弹窗取消 | md |
outline |
neutral |
| 列表项删除 | sm |
ghost |
danger |
| 表单次要帮助 | sm |
ghost |
neutral |
如设计稿出现 md / ghost / brand,先判断它表达的是品牌次操作还是低强调操作:前者改为 outline / brand,后者改为 ghost / neutral。不要为单个页面偷偷补一个例外。
验收时每一行都要能在组件库中找到对应实例;同一组属性不允许因页面不同而产生两套边框、字号或圆角值。对于 danger 相关操作,还应检查按钮文案与确认流程,不能仅凭红色传达风险。
让 Figma 与开发参数一一对应
在 Figma 的 Button 组件集中采用三个 Variant 属性:Size=sm、Variant=solid、Tone=brand。属性值保持小写,展示标签可以首字母大写。代码侧分别使用 size、variant、tone,取值集合与允许矩阵相同。
以下是 TypeScript 类型约束示例,可保存为 TypeScript 项目中的 button-props-check.ts 进行检查。它描述组件参数契约,不包含按钮渲染实现。
type Size = 'sm' | 'md' | 'lg';
type Appearance =
| { variant: 'solid' | 'outline'; tone: 'brand' | 'neutral' | 'danger' }
| { variant: 'ghost'; tone: 'neutral' | 'danger' };
type ButtonProps = { size: Size; disabled?: boolean } & Appearance;
const allowed: ButtonProps = { size: 'sm', variant: 'ghost', tone: 'danger' };
// @ts-expect-error 不允许 ghost 与 brand 组合
const rejected: ButtonProps = { size: 'md', variant: 'ghost', tone: 'brand' };预期结果:在已安装 TypeScript 的项目根目录执行 npx tsc --noEmit button-props-check.ts,类型检查通过且没有控制台输出;删除 @ts-expect-error 后,rejected 会触发类型错误。
这里使用判别联合类型明确限制 variant 与 tone 的合法配对。如果只是把三个属性分别声明为独立的字符串联合类型,编译器无法拦截 ghost + brand。
Figma 不建立对应的禁止组合变体,开发也无法合法传入该组合。disabled 由运行时布尔值控制,设计库另行维护它的状态示例。设计侧的 State=disabled 用于检查视觉效果,不必成为业务代码可以任意设置的 state 字符串。
用增量成本决定是否加新属性
收到“成功操作需要绿色按钮”的需求时,不要立即把 success 加入全部组合。先查使用位置与替代方案:如果只在通知里出现,优先归属 Alert;如果确有多个提交成功后的可操作场景,再考虑 Button 的 tone=success。
例如只开放 solid + success,新增量是 3 种尺寸 × 1 组配对 = 3 个规格,总数从 24 变成 27,而不是一次增加 9 个。评审记录应同时更新允许矩阵、Figma 实例、类型定义以及默认态和焦点态的视觉验收样例。
新增 size 也要检查布局成本。例如把第四档 xl 直接开放给现有全部 8 组外观与语义色,会新增 8 个规格;如果实际只有落地页主操作需要更大的按钮,可先评估是否应使用页面级组合样式,而非扩展整个基础组件。
维护时以“新需求对应哪一格、增加多少合法规格、代码能否拒绝非法组合”作为检查标准;答不清这三项时,先不要扩展公开属性。