UI 视觉设计 / 系统课时

按复用层级划分组件目录

按复用层级划分组件目录

本课将商品购买界面中的按钮、数量选择器和订单信息拆分为基础控件、复合组件与业务组件,并为每层确定目录和依赖边界。完成后,你可以按组件职责决定放置位置,避免把库存规则、接口请求和订单计算混入通用组件。

学习目标

  • 根据组件的职责、业务知识和复用范围判断所属层级。
  • 建立三层组件目录,明确允许的依赖方向与数据边界。
  • 使用具体检查项识别过度抽象、业务逻辑泄漏和错误复用。

用职责而不是页面位置划分层级

同一个页面上的元素不一定属于同一层。判断组件归属时,先问它是否理解商品、订单等业务概念,再看它是否需要组合其他组件,最后确认它能够在哪些场景复用。

层级 判断标准 典型组件 职责边界
基础控件 不需要业务对象即可独立使用 Button、Input、Icon、Checkbox 处理外观、基础交互、禁用态、焦点和可访问性
复合组件 组合基础控件,形成跨场景交互能力 QuantityStepper、ConfirmDialog、SearchField 管理局部状态、通用校验与交互协调
业务组件 直接表达特定业务实体或规则 ProductPurchasePanel、OrderSummary、OrderStatusBadge 解释业务数据、组合通用组件、衔接业务操作

例如,普通 Badge 只接收文字和视觉样式,可以属于基础控件;OrderStatusBadge 如果负责把订单状态 pending、paid、cancelled 转成中文标签和视觉状态,就属于业务组件。

不要单凭使用次数判断层级。一个订单状态卡片即使在五个订单页面出现,也不代表它适合进入全局基础控件库。

拆解一个商品购买区域

假设商品详情页需要显示单价 120 元、库存 5 件、数量选择器和加入购物车按钮。可以按职责将这一区域拆成三个层级。

  1. 基础控件 Button 负责点击、禁用、焦点状态和视觉变体。它不知道点击后是加入购物车还是保存设置。
  2. 复合组件 QuantityStepper 使用按钮和输入控件,接收 value=2、min=1、max=5、step=1,负责增减数量、边界限制和触发 onChange。
  3. 业务组件 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 结算业务组件

依赖遵循以下规则:

  1. 基础控件层可以依赖框架、设计变量、通用类型和必要的无业务工具,但不得导入商品、订单、业务接口或业务状态管理模块。
  2. 复合组件层可以依赖基础控件和其他不形成循环依赖的通用能力,通过属性与回调暴露交互结果,不直接调用特定业务接口。
  3. 业务组件层可以依赖前两层,并在所属业务模块中组合业务模型、状态和用例。跨业务模块使用时应通过明确的公共接口,而不是任意互相导入内部文件。

例如,确认弹窗可以暴露 open、title、onConfirm、onCancel,但不能在通用组件内部固定调用 cancelOrder()。取消订单的业务组件负责传入对应确认回调。

通过复用评审检查组件边界

假设商品详情页和购物车页都出现数量选择器,可以使用以下检查项决定是否抽为通用组件。

检查项 通过条件 不通过时的处理
去业务化 删除商品类型后仍能定义交互 把库存、商品信息移到业务层
通用输入 使用 value、min、max、step 等参数 用参数替代硬编码业务数值
输出独立 通过 onChange 返回数量 移除组件内部的购物车接口调用
依赖方向 只导入同层合规模块或下层模块 拆除向业务层的反向依赖
可验证性 min=1、max=5 时不能增到 6 或减到 0 在复合层修复边界行为

一次实际评审可以这样进行:

  1. 列出商品详情、购物车和结算三个界面中重复出现的元素。
  2. 将 Button、QuantityStepper 和 ProductPurchasePanel 分别放入基础、复合、业务目录。
  3. 检查基础和复合目录中的导入关系,确认不存在对 features 业务目录的反向依赖。
  4. 用人数选择场景替换商品场景,将 QuantityStepper 的 max 改为 20,验证它不需要商品字段仍能使用。
  5. 检查商品库存从 5 降为 3 时,业务层是否正确更新数量上限,并在提交时保留服务端库存校验。

验收时,至少应确认三个结果:基础控件不含业务词汇和业务依赖;复合组件可由不同业务传入参数复用;业务组件负责解释领域数据与执行领域操作。若某个组件只有订单页面使用且需要订单状态、金额或权限规则,就保留在订单业务目录中,不必为了追求复用而提升到通用层。

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

目录与阅读设置

阅读设置

17

记录一个想法

按复用层级划分组件目录

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

登录哪都通