UI 视觉设计 / 系统课时

用组件盘点表定位重复实现

用组件盘点表定位重复实现

同一个系统中的按钮,可能在不同页面有不同高度,也可能外观一致却维护着多份代码。本课以电商产品的典型页面为样本,建立可追溯的组件盘点表,识别同名不同形、重复开发和规范缺失,并把发现的问题转化为明确的组件治理任务。

学习目标

  • 选择具有代表性的页面,确定组件盘点的范围、颗粒度和记录字段。
  • 使用组件盘点表识别视觉不一致、重复实现和缺少交互规范的问题。
  • 根据盘点证据提出组件合并、变体保留和规范补全的处理方案。

选择代表性页面并确定盘点边界

组件盘点不必从整个产品的所有页面开始。优先选择包含高频操作、重复控件和不同业务流程的页面,通常能更快暴露共性问题。

以电商后台及交易流程为例,第一轮选择四个页面:

页面 重点观察对象 选择原因
商品详情 主按钮、数量选择器、提示信息 覆盖购买入口和商品状态
购物车 结算按钮、数量输入、删除确认弹窗 包含批量操作与破坏性操作
订单确认 提交按钮、表单输入、校验反馈 覆盖加载、禁用与错误状态
订单列表 搜索框、筛选控件、操作弹窗 覆盖数据操作与复合交互

盘点前固定观察条件:桌面端选取宽度为 1440px 的视口,移动端选取 390px;记录适用的 Default、Hover、Focus、Disabled 和 Loading 状态。触屏端没有常规鼠标悬停状态,不需要人为补造 Hover 截图。

按以下步骤执行:

  1. 打开页面,标记可交互区域和重复出现的视觉单元。
  2. 对每个组件实例记录页面位置、名称、外观、行为和状态。
  3. 在代码仓库中查找对应的实现文件,确认是否复用现有组件。
  4. 为记录分配唯一编号,并保存带页面名称、视口宽度和状态信息的截图证据。

盘点颗粒度以组件实例为单位,而不是以每个 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、视觉变体和交互规范时,可以直接使用这些记录作为依据。

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

目录与阅读设置

阅读设置

17

记录一个想法

用组件盘点表定位重复实现

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

登录哪都通