UI 视觉设计 / 系统课时
按复用层级划分组件目录
按复用层级划分组件目录
本课将商品购买界面中的按钮、数量选择器和订单信息拆分为基础控件、复合组件与业务组件,并为每层确定目录和依赖边界。完成后,你可以按组件职责决定放置位置,避免把库存规则、接口请求和订单计算混入通用组件。
学习目标
- 根据组件的职责、业务知识和复用范围判断所属层级。
- 建立三层组件目录,明确允许的依赖方向与数据边界。
- 使用具体检查项识别过度抽象、业务逻辑泄漏和错误复用。
用职责而不是页面位置划分层级
同一个页面上的元素不一定属于同一层。判断组件归属时,先问它是否理解商品、订单等业务概念,再看它是否需要组合其他组件,最后确认它能够在哪些场景复用。
| 层级 | 判断标准 | 典型组件 | 职责边界 |
|---|---|---|---|
| 基础控件 | 不需要业务对象即可独立使用 | Button、Input、Icon、Checkbox | 处理外观、基础交互、禁用态、焦点和可访问性 |
| 复合组件 | 组合基础控件,形成跨场景交互能力 | QuantityStepper、ConfirmDialog、SearchField | 管理局部状态、通用校验与交互协调 |
| 业务组件 | 直接表达特定业务实体或规则 | ProductPurchasePanel、OrderSummary、OrderStatusBadge | 解释业务数据、组合通用组件、衔接业务操作 |
例如,普通 Badge 只接收文字和视觉样式,可以属于基础控件;OrderStatusBadge 如果负责把订单状态 pending、paid、cancelled 转成中文标签和视觉状态,就属于业务组件。
不要单凭使用次数判断层级。一个订单状态卡片即使在五个订单页面出现,也不代表它适合进入全局基础控件库。
拆解一个商品购买区域
假设商品详情页需要显示单价 120 元、库存 5 件、数量选择器和加入购物车按钮。可以按职责将这一区域拆成三个层级。
- 基础控件
Button负责点击、禁用、焦点状态和视觉变体。它不知道点击后是加入购物车还是保存设置。 - 复合组件
QuantityStepper使用按钮和输入控件,接收value=2、min=1、max=5、step=1,负责增减数量、边界限制和触发onChange。 - 业务组件
ProductPurchasePanel读取商品库存、决定数量上限,并将选定数量交给加入购物车的业务操作。实际库存仍由服务端最终校验。
这里的 QuantityStepper 不应该直接读取商品库存。换到会议室人数选择场景时,调用方只需传入 min=1、max=20,同一个组件就能复用。

要特别区分通用交互规则与业务规则:限制数量不能低于 min 属于数量选择器的通用能力;根据库存决定 max、判断商品能否加入购物车,则属于业务层。
建立目录和单向依赖规则
在使用 React 和 TypeScript 的示例项目中,可以采用以下目录约定。目录名是团队约定,不是框架强制要求。
| 目录或文件 | 放置内容 |
|---|---|
src/components/primitives/Button.tsx |
通用按钮 |
src/components/primitives/Input.tsx |
通用输入控件 |
src/components/composites/QuantityStepper.tsx |
数量选择器 |
src/components/composites/ConfirmDialog.tsx |
通用确认弹窗 |
src/features/catalog/components/ProductPurchasePanel.tsx |
商品购买业务组件 |
src/features/checkout/components/OrderSummary.tsx |
结算业务组件 |
依赖遵循以下规则:
- 基础控件层可以依赖框架、设计变量、通用类型和必要的无业务工具,但不得导入商品、订单、业务接口或业务状态管理模块。
- 复合组件层可以依赖基础控件和其他不形成循环依赖的通用能力,通过属性与回调暴露交互结果,不直接调用特定业务接口。
- 业务组件层可以依赖前两层,并在所属业务模块中组合业务模型、状态和用例。跨业务模块使用时应通过明确的公共接口,而不是任意互相导入内部文件。
例如,确认弹窗可以暴露 open、title、onConfirm、onCancel,但不能在通用组件内部固定调用 cancelOrder()。取消订单的业务组件负责传入对应确认回调。
通过复用评审检查组件边界
假设商品详情页和购物车页都出现数量选择器,可以使用以下检查项决定是否抽为通用组件。
| 检查项 | 通过条件 | 不通过时的处理 |
|---|---|---|
| 去业务化 | 删除商品类型后仍能定义交互 | 把库存、商品信息移到业务层 |
| 通用输入 | 使用 value、min、max、step 等参数 |
用参数替代硬编码业务数值 |
| 输出独立 | 通过 onChange 返回数量 |
移除组件内部的购物车接口调用 |
| 依赖方向 | 只导入同层合规模块或下层模块 | 拆除向业务层的反向依赖 |
| 可验证性 | min=1、max=5 时不能增到 6 或减到 0 |
在复合层修复边界行为 |
一次实际评审可以这样进行:
- 列出商品详情、购物车和结算三个界面中重复出现的元素。
- 将
Button、QuantityStepper和ProductPurchasePanel分别放入基础、复合、业务目录。 - 检查基础和复合目录中的导入关系,确认不存在对
features业务目录的反向依赖。 - 用人数选择场景替换商品场景,将
QuantityStepper的max改为 20,验证它不需要商品字段仍能使用。 - 检查商品库存从 5 降为 3 时,业务层是否正确更新数量上限,并在提交时保留服务端库存校验。
验收时,至少应确认三个结果:基础控件不含业务词汇和业务依赖;复合组件可由不同业务传入参数复用;业务组件负责解释领域数据与执行领域操作。若某个组件只有订单页面使用且需要订单状态、金额或权限规则,就保留在订单业务目录中,不必为了追求复用而提升到通用层。