UI 视觉设计 / 系统课时
建立组件命名和收录规则
建立组件命名和收录规则
设计稿中的“蓝按钮”、开发口中的“提交按钮”,可能实际指向同一个组件;反过来,都叫“弹窗”的控件也可能有不同交互。本篇建立唯一主名、同义词索引、分类路径和收录门槛,最终得到一份设计与代码都能使用的组件台账。
学习目标
- 为界面元素确定稳定的语义主名,并把外观差异放入属性与状态。
- 建立同义词检索、分类路径和旧名称迁移规则。
- 用可核验的条件决定组件收录、候选或业务私有。
用职责命名,不用页面或颜色命名
建议组件主名统一采用英文单数名词与 PascalCase,例如 Button、TextField、Dialog、Toast。名称表示用户能完成的操作或界面承担的职责,避免使用 BlueButton、OrderSubmitButton、NewDialogV2 这类依赖外观、页面或版本的名称。
以订单页的“提交订单”和设置页的“保存”为例:如果两者都是触发即时操作的标准按钮,就共同归入 Button。将视觉差异表达为团队定义的 variant=primary|secondary,大小表达为 size=sm|md|lg,加载、禁用则列为状态,不为每种组合新建组件。
命名时先检查行为,再检查外观。Dialog 会承载需要明确处理或关闭的对话任务;Popover 通常附着在触发元素旁展示补充内容。即使它们都是浮层,也不应仅因形状相近而合并。
用同义词指向唯一主名
为每个主名建立可检索的别名,不把别名作为第二套组件资源。建议先整理如下词表:
| 唯一主名 | 可检索同义词 | 不应当作主名的名称 |
|---|---|---|
Button |
按钮、操作按钮 | BlueButton |
Dialog |
对话框、Modal、模态对话框 | NewDialogV2 |
Toast |
轻提示、非阻断消息 | SuccessGreenToast |
同义词只能映射到一个主名。“弹窗”“Popup”可能同时指向 Dialog、Popover 或其他浮层,须先确认触发方式和交互行为,不能自动设为其中一个的别名。别名冲突应记录为“待判定”,而不是复制出第二套组件。
改名时在台账保存旧名、目标主名、弃用状态、负责人和迁移截止版本。团队可以约定旧检索词至少保留一个发布周期;设计库与代码包应同步公布替代名称,但是否保留旧导出需另按兼容性评估,不能只改设计稿标题。
固定分类路径和检索字段
每个组件只登记一个规范路径,避免同时散落在“通用”“业务”“常用”三个文件夹。下面是可直接采用的初始分类:
Components / Actions / ButtonComponents / Inputs / TextFieldComponents / Feedback / ToastComponents / Overlays / Dialog
分类按主要用途,不按页面来源;“结账页按钮”仍归 Actions,使用场景写在标签中。台账最少包含“主名、规范路径、中文别名、英文别名、用途描述、状态、设计负责人、代码负责人”八列。搜索结果只展示一个规范条目,别名检索跳转到该条目。

用四道门槛决定是否收录
遇到新控件,先留存页面截图和使用场景,再逐项判断:
- 复用证据:已在至少两个独立页面或业务流程使用;
Button等基础控件可作平台级例外,但须记录原因。 - 语义与行为一致:核心结构、触发方式和用户预期相同;仅颜色、尺寸或文案不同,应采用变体或内容槽位。
- 规格可描述:明确组成部分、可选变体和适用状态。对按钮至少核对默认、悬停、键盘焦点、禁用;如支持异步提交,还要定义加载态。
- 可交付:有设计及代码负责人、使用示例、键盘与焦点行为说明,以及后续变更入口。
四项满足才进入公共组件库。复用尚不足但潜力明确的标为“候选”;行为不一致的拆分语义或改为组合模式;仅服务单一业务的保留在业务层,不靠新增通用组件凑目录数量。

先用小样本验证规则
从现有产品抽取 20 个真实控件实例,让一名设计师和一名工程师独立填写“主名、规范路径、同义词、收录结论”,再对照差异。可把试运行通过线设为:至少 18 个实例主名一致、同义词一对多冲突为 0、相同主名的重复代码导出为 0;这是团队验收建议值,不是行业标准。
例如订单页“提交订单”与设置页“保存”应收敛为 Button;只出现一次且无法抽离业务数据的“专属优惠组合卡”先留在业务层。若两人对“弹窗”归属不一致,应补充“是否模态、是否附着触发元素、如何关闭”等判据,再复核原样本。确认无冲突后,才批量迁移设计资产与代码引用。