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 在三个尺寸下都不建立实例。

Button 三属性组合、无效组合过滤与双端映射

把矩阵作为组件收录规则:设计库只制作这 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 进行检查。它描述组件参数契约,不包含按钮渲染实现。

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 个规格;如果实际只有落地页主操作需要更大的按钮,可先评估是否应使用页面级组合样式,而非扩展整个基础组件。

维护时以“新需求对应哪一格、增加多少合法规格、代码能否拒绝非法组合”作为检查标准;答不清这三项时,先不要扩展公开属性。

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

目录与阅读设置

阅读设置

17

记录一个想法

用属性矩阵收敛尺寸与变体

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

登录哪都通