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 / Button
  • Components / Inputs / TextField
  • Components / Feedback / Toast
  • Components / Overlays / Dialog

分类按主要用途,不按页面来源;“结账页按钮”仍归 Actions,使用场景写在标签中。台账最少包含“主名、规范路径、中文别名、英文别名、用途描述、状态、设计负责人、代码负责人”八列。搜索结果只展示一个规范条目,别名检索跳转到该条目。

界面称呼经同义词映射进入唯一组件目录,并关联设计库与代码包

用四道门槛决定是否收录

遇到新控件,先留存页面截图和使用场景,再逐项判断:

  1. 复用证据:已在至少两个独立页面或业务流程使用;Button 等基础控件可作平台级例外,但须记录原因。
  2. 语义与行为一致:核心结构、触发方式和用户预期相同;仅颜色、尺寸或文案不同,应采用变体或内容槽位。
  3. 规格可描述:明确组成部分、可选变体和适用状态。对按钮至少核对默认、悬停、键盘焦点、禁用;如支持异步提交,还要定义加载态。
  4. 可交付:有设计及代码负责人、使用示例、键盘与焦点行为说明,以及后续变更入口。

四项满足才进入公共组件库。复用尚不足但潜力明确的标为“候选”;行为不一致的拆分语义或改为组合模式;仅服务单一业务的保留在业务层,不靠新增通用组件凑目录数量。

组件依据复用证据、语义一致性与交付完整度进入不同收录结果

先用小样本验证规则

从现有产品抽取 20 个真实控件实例,让一名设计师和一名工程师独立填写“主名、规范路径、同义词、收录结论”,再对照差异。可把试运行通过线设为:至少 18 个实例主名一致、同义词一对多冲突为 0、相同主名的重复代码导出为 0;这是团队验收建议值,不是行业标准。

例如订单页“提交订单”与设置页“保存”应收敛为 Button;只出现一次且无法抽离业务数据的“专属优惠组合卡”先留在业务层。若两人对“弹窗”归属不一致,应补充“是否模态、是否附着触发元素、如何关闭”等判据,再复核原样本。确认无冲突后,才批量迁移设计资产与代码引用。

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

目录与阅读设置

阅读设置

17

记录一个想法

建立组件命名和收录规则

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

登录哪都通