--- --- ## 告别“上帝组件”！弹窗数据流设计的两种高级架构方案 --- ### 痛点回顾：我们是如何把代码写成“意大利面条”的？ 我们先来看一段典型的“坏味道”代码。在一个采购查询页签（`ProcurementQueryTab`）中，包含 `ExpandDialog`（扩充弹窗）和 `CopyDialog`（复制弹窗）两个业务组件，它们都需要打开一个公共的 `MaterialDialog`（物料选择弹窗）。 **现状组件结构：** ```plaintext ProcurementQueryTab (上帝父组件) ├─ 管理 3 个弹窗的 visible 状态 (expand, material, copy) ├─ 管理物料弹窗上下文: materialDialogContext ('expand' | 'copy-new' | 'copy-from') ├─ │ └─ 点击搜索物料 → emit 给父组件 └─ └─ 点击搜索物料 → emit 给父组件 ``` 这种设计的“痛点”究竟在哪里？父组件不仅要负责打开弹窗，还须时刻记录“是谁调用了我”，并在用户选择物料后，像接线员一样将结果分派回去。 **“接线员”代码节选：** ```typescript // ProcurementQueryTab.vue 中的分发逻辑 function handleMaterialConfirm(row: any) { switch (materialDialogContext.value) { case 'expand': clickNodeKey.value.materialCode = row.materialCode; // 直接修改深层对象 break; case 'copy-new': copyFormMaterialCodeNew.value = row.materialCode; // 修改特定变量 (copyDialogRef.value as any)?.setMaterialCode(...); // 还得调用子组件方法 break; // ... 每多一种场景，这里就多一个 case } } ``` 这种架构直接导致了**四大设计缺陷**： 1. **上帝对象**：父组件知晓所有子组件内部逻辑，成为全知全能的“上帝”，极度膨胀。 2. **数据流绕圈**：数据从子组件出发，绕父组件转一圈又回到子组件，链路极长。 3. **字符串模拟状态机**：使用 `materialDialogContext` 字符串标记分流，并发场景下极易出错。 4. **缺乏单一数据源**：`clickNodeKey` 被多处直接修改，后续维护稍有不慎即引发 Bug。 如何解耦？下面介绍两种优雅的架构模式。 ### 方案 A：自包含组件模式（Compound Component） #### 核心思想：组件内部自治 在此模式下，`ExpandDialog` 不再依赖父组件管理物料弹窗，而是**内部自行处理**。 #### 数据流简化：直线 vs 环形 - **旧方案（环形）**：`ExpandDialog` → 父组件 → `MaterialDialog` → 父组件 → `ExpandDialog` - **新方案（直线）**：`ExpandDialog` → `MaterialDialog` → `ExpandDialog` 父组件彻底退出物料弹窗的交互流程，仅负责最外层业务弹窗的显示/隐藏以及最终结果的接收。 #### 代码实现：高内聚的 ExpandDialog **ExpandDialog.vue (改造后)：** ```vue ``` 父组件此时仅需极简调用： ```vue ``` #### 架构评估：简洁易用，但需权衡代价 | 优势 | 代价 | | :--- | :--- | | **简单直观**：组件树结构与UI层级一致，符合直觉。 | **DOM冗余**：每个业务组件内都拷贝了一份 MaterialDialog 的模板。 | | **易维护**：所有相关逻辑锁在一个文件里，改起来很安心。 | **多实例开销**：页面同时存在多个不可见的弹窗实例。 | | **父组件瘦身**：父组件代码量锐减，回归容器本质。 | **交互一致性风险**：如果弹窗配置不统一，不同地方的弹窗体验可能割裂。 | **适用场景**：使用物料弹窗的业务组件数量较少（≤3个），且各组件业务逻辑差异较大。 ### 方案 B：Promise 中介者模式（Headless State Machine） #### 核心思想：将弹窗视为异步函数，而非组件 如果我们将“打开弹窗并等待结果”的过程，封装为一个返回 Promise 的函数调用，那么代码将变得异常简洁。这背后需要借助**无头组件（Headless UI）**的设计理念。 #### 架构分层：逻辑与视图完全分离 - **Composable 层（无头）**：纯 JS/TS 逻辑，维护 Promise 状态机，不渲染任何 DOM。 - **UI 层（视图）**：仅负责按照 Composable 的指令渲染弹窗。 通过 Vue 的 `provide/inject`，我们在组件树根部注入一个全局唯一的弹窗“中介者”。 #### 代码实现：像调用 API 一样使用弹窗 **1. 定义 Composable 中介者：** ```typescript // composables/useMaterialSelector.ts export function provideMaterialSelector() { const visible = ref(false); let pendingResolver = null; // Promise 的 resolve 函数 // 核心：返回 Promise 的打开方法 const openMaterial = (catCode) => { return new Promise((resolve) => { pendingResolver = resolve; visible.value = true; }); }; const handleConfirm = (row) => { visible.value = false; pendingResolver?.(row); // 决议 Promise pendingResolver = null; }; provide(KEY, { visible, openMaterial, handleConfirm }); } ``` **2. 业务组件调用，丝般顺滑：** ```typescript // ExpandDialog.vue 中 const { openMaterial } = useMaterialSelector(); async function handleSearchMaterial() { // 一行代码拉起弹窗，并异步等待用户选择结果！ const row = await openMaterial(form.catCode); if (!row) return; // 用户取消了 // 直接回填，无任何中间商赚差价 form.materialCode = row.materialCode; form.materialLongDesc = row.materialLongDesc; } ``` #### 架构评估：工业级优雅，但存在学习成本 | 优势 | 代价 | | :--- | :--- | | **调用极简**：`const row = await openMaterial()`，屏蔽了所有中间流程。 | **学习曲线**：团队需要理解 Promise 异步编排和依赖注入。 | | **全局单例**：组件树中只有一份 MaterialDialog DOM，统一交互。 | **抽象层深**：数据流不直观，调试需追踪 Promise 链路。 | | **高扩展性**：新增 loading、超时、重试等能力，只改 Composable，调用方无感。 | **过度设计风险**：场景简单时，可能把简单问题复杂化。 | | **逻辑可测**：无 DOM 依赖的 Composable 逻辑极易进行单元测试。 | | **适用场景**：使用物料弹窗的业务组件数量较多（≥5个），且增长趋势明显，对交互体验统一性要求较高。 ### 终极对比：三张图看清架构选型 | 维度 | 原始方案（现状） | 方案 A（自包含） | 方案 B（Promise） | | :--- | :--- | :--- | :--- | | **设计哲学** | 父组件统一管控 | 组件内部自治 | 弹窗 = 异步函数 | | **数据流** | 环形绕圈 | 组件内直线 | 函数式调用-返回 | | **DOM开销** | 1个全局弹窗 | N个实例 | 1个全局单例 | | **父组件代码量** | 极多 | 极少 | 中等 | | **调用方复杂度** | 低（仅 emit） | 中（内置弹窗） | **极低**（一行 await） | | **扩展性** | 极差 | 一般 | **极佳** | ### 面试官问我如何选择？我的决策框架 如果这是一道面试题，我会这样回答，以展示我的架构决策能力： **总结核心原则：** 运用单一职责原则（SRP）划清组件边界，借助依赖倒置原则（DIP）使逻辑依赖抽象（Promise契约）而非具体实现，最终实现对修改关闭、对扩展开放（OCP）的健壮系统。 --- **附录：相关资源** - Headless UI (React) — Headless 组件模式的经典实现 - TanStack Table — 著名的 Headless 表格库 - Vue Composition API 官方文档 - Compound Components Pattern — Kent C. Dodds 的复合组件模式文章