UI 视觉设计 / 系统课时
用组件盘点表定位重复实现
用组件盘点表定位重复实现
同一个系统中的按钮,可能在不同页面有不同高度,也可能外观一致却维护着多份代码。本课以电商产品的典型页面为样本,建立可追溯的组件盘点表,识别同名不同形、重复开发和规范缺失,并把发现的问题转化为明确的组件治理任务。
学习目标
- 选择具有代表性的页面,确定组件盘点的范围、颗粒度和记录字段。
- 使用组件盘点表识别视觉不一致、重复实现和缺少交互规范的问题。
- 根据盘点证据提出组件合并、变体保留和规范补全的处理方案。
选择代表性页面并确定盘点边界
组件盘点不必从整个产品的所有页面开始。优先选择包含高频操作、重复控件和不同业务流程的页面,通常能更快暴露共性问题。
以电商后台及交易流程为例,第一轮选择四个页面:
| 页面 | 重点观察对象 | 选择原因 |
|---|---|---|
| 商品详情 | 主按钮、数量选择器、提示信息 | 覆盖购买入口和商品状态 |
| 购物车 | 结算按钮、数量输入、删除确认弹窗 | 包含批量操作与破坏性操作 |
| 订单确认 | 提交按钮、表单输入、校验反馈 | 覆盖加载、禁用与错误状态 |
| 订单列表 | 搜索框、筛选控件、操作弹窗 | 覆盖数据操作与复合交互 |
盘点前固定观察条件:桌面端选取宽度为 1440px 的视口,移动端选取 390px;记录适用的 Default、Hover、Focus、Disabled 和 Loading 状态。触屏端没有常规鼠标悬停状态,不需要人为补造 Hover 截图。
按以下步骤执行:
- 打开页面,标记可交互区域和重复出现的视觉单元。
- 对每个组件实例记录页面位置、名称、外观、行为和状态。
- 在代码仓库中查找对应的实现文件,确认是否复用现有组件。
- 为记录分配唯一编号,并保存带页面名称、视口宽度和状态信息的截图证据。
盘点颗粒度以组件实例为单位,而不是以每个 DOM 节点为单位。一个包含文字与图标的按钮仍算一个按钮实例;不同状态可以记录在同一行,不必拆成五条组件。
建立可追溯的组件盘点表
推荐使用电子表格维护清单。最少保留组件 ID、页面位置、暂定组件名称、视觉属性、交互行为、状态、实现来源、证据编号和问题标记九项信息。
以下是一份演示用盘点结果。尺寸与文件名均为假设项目的现状记录,并非推荐设计规范。
| ID | 组件及位置 | 视觉与变体 | 交互及状态 | 实现来源与证据 |
|---|---|---|---|---|
| C01 | 商品详情/加入购物车 | Primary,高 40px,圆角 8px | 点击加入;无库存时禁用 | ProductAddButton.tsx,E01 |
| C02 | 购物车/去结算 | Primary,高 44px,圆角 12px | 点击跳转结算页 | CartCheckoutButton.tsx,E02 |
| C03 | 订单确认/提交订单 | Primary,高 40px,圆角 8px | 提交请求;Loading 防重复提交 | SubmitOrderButton.tsx,E03 |
| C04 | 购物车/删除商品 | ConfirmDialog,宽 360px | 确认删除;Esc 无响应 | RemoveItemDialog.tsx,E04 |
| C05 | 订单列表/取消订单 | ConfirmDialog,宽 400px | 确认取消;Esc 可关闭 | CancelOrderDialog.tsx,E05 |
| C06 | 订单列表/搜索订单 | SearchInput,高 36px | 输入后 300ms 触发搜索 | OrderSearchInput.tsx,E06 |
每条证据应能回答三个问题:界面长什么样、用户操作后发生什么、实际由哪段实现负责。例如 E03 应同时关联提交按钮的默认态与加载态截图,以及对应代码位置。
组件名称先视为盘点标签,不直接当作最终规范。两个控件都叫 Primary,并不代表它们已经符合统一标准;两个文件名不同,也不必然代表存在重复开发。
对照实例识别三类问题
完成登记后,按组件语义和使用场景分组,而不是仅按文件名排序。重点检查以下三种异常。
| 问题类型 | 判定依据 | 本例发现 | 处理方向 |
|---|---|---|---|
| 同名不同形 | 相同语义、相同预期规格,视觉属性却不一致 | C01 与 C02 高度相差 4px、圆角相差 4px | 核实是否为合法尺寸变体 |
| 重复实现 | 不同文件重复编写相似的通用视觉和交互基础能力 | C01 与 C03 均独立实现相同外观的主按钮 | 提取共享按钮基础组件 |
| 缺少规范 | 相同交互类型的状态或键盘行为不一致,且无明确规则 | C04 与 C05 对 Esc 的响应不同 | 补齐弹窗关闭及焦点管理规范 |

识别同名不同形时,要先排除合法差异。例如移动端为了提高触控可操作性,可能使用更大的按钮尺寸。只有在相同组件变体和相同使用条件下出现未被规范允许的差异,才应直接判为视觉漂移。
识别重复实现时,要同时检查视觉层与业务层。C01 负责加入购物车,C03 负责提交订单,两者业务行为不同;可以共享按钮基础组件,但不应该合并业务处理函数。真正需要消除的是重复维护的样式、状态表现和基础交互逻辑。
对于 ConfirmDialog,重点检查打开后的初始焦点、Tab 焦点约束、Esc 关闭策略、关闭后焦点返回位置,以及危险操作是否需要二次确认。Esc 是否允许关闭应有明确规则,不能仅凭两个弹窗当前行为不同就决定全部统一为可关闭。
将问题登记为可执行的治理任务
发现异常后,建立独立的问题记录,保留证据、责任人和验收标准。不要直接修改所有相似组件,否则容易把业务需要的差异误当成错误。
| 问题 ID | 对应实例 | 优先级示例 | 具体任务 |
|---|---|---|---|
| F01 | C01、C02 | P1 | 评审 Primary 的高度与圆角,确认标准尺寸和合法变体 |
| F02 | C01、C03 | P2 | 核对重复代码,抽取共享 Button 视觉及基础状态能力 |
| F03 | C04、C05 | P1 | 定义 Dialog 的 Esc、焦点约束与关闭后焦点返回规则 |
本例使用 P1 表示需要在组件规范发布前处理,P2 表示可纳入后续重构。优先级只是演示项目的约定;实际应根据用户影响、使用频率和修改风险调整。若弹窗存在导致键盘用户无法完成操作的严重问题,应提高处理优先级。
对于 F01,可以暂拟 Primary 默认尺寸为高 40px、圆角 8px,并要求设计负责人确认 C02 是否确实需要独立的大尺寸变体。如果需要保留,应补充变体名称、尺寸、适用场景和设计稿,而非允许页面自行设置任意高度。
对于 F02,先抽取公共 Button 的外观与 Disabled、Loading 等通用状态,再由商品和订单模块分别传入业务处理逻辑。重构前后应验证两处业务操作结果保持不变。
对于 F03,应输出明确的 Dialog 行为规范,并以键盘检查验证:打开弹窗后焦点进入弹窗;Tab 不应错误地移动到背景交互区域;允许 Esc 关闭时,关闭后焦点返回合理位置。危险操作的取消与确认按钮还需分别验证。
用盘点结果确定下一步组件边界
每个发现最终应落入以下三种处理结果之一:合并为共享组件、保留有依据的变体,或补写缺失规范。对于用途不同但外观相似的控件,优先共享基础能力,避免制造一个包含大量业务判断的万能组件。
本次样本共登记 6 个组件实例,产生 3 条待处理问题。完成盘点后,用以下条件验收交付物:
- 6 条记录均有页面位置、交互说明、实现来源和证据编号,证据可以复现。
- F01 有明确的尺寸决策;合法差异已登记为变体,非预期差异有修复目标。
- F02 有共享组件候选及业务逻辑保留说明,并能覆盖默认、禁用与加载状态的回归检查。
- F03 有键盘与焦点行为验收项,且明确责任人。
- 每条问题都有处理状态,例如待核实、待设计评审、待开发、已验证;未经确认的差异不能直接标为已解决。
这样得到的不是一份单纯的截图列表,而是一套从页面实例、代码来源到问题决策均可追溯的组件清单。后续制定组件 API、视觉变体和交互规范时,可以直接使用这些记录作为依据。