From 3b09d45f080040f008173a4c33bf3d91966c6245 Mon Sep 17 00:00:00 2001 From: yin <3313488199@qq.com> Date: Fri, 6 Nov 2026 18:01:24 +0800 Subject: [PATCH] =?UTF-8?q?refactor(list):=20=E6=8A=BD=E7=A6=BB=E5=88=97?= =?UTF-8?q?=E8=A1=A8=E9=A1=B5=E5=85=AC=E5=85=B1=E6=A8=A1=E6=9D=BF=E4=B8=8E?= =?UTF-8?q?=E5=85=B1=E4=BA=AB=E5=B7=A5=E5=85=B7=EF=BC=8C=E4=BC=98=E5=8C=96?= =?UTF-8?q?=E8=99=9A=E6=8B=9F=E6=BB=9A=E5=8A=A8=E4=B8=8E=E7=8A=B6=E6=80=81?= =?UTF-8?q?=E6=B8=B2=E6=9F=93?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 新增 ToolbarButtonGroup 组件及类型定义,订单、波次等页面统一使用, 工具栏按钮样式分类(刷新/设置/操作/取消)收敛到一处 - 订单共享模块迁移至 views/order/shared:创建订单会话、通用表单、 导出、工具栏动作、订单元数据缓存;stockPickerHelpers 归入 stock/utils - 抽离 ScanBox 字段工厂、货主/快递下拉选项映射、状态文本工具, 新增 list-page.scss、status-text.scss,order-common-config 改为再导出 - UpperTable 虚拟滚动优化:实测行高兜底、渲染行数组引用复用、 rowKey/复制码/收起文本缓存、窗口行数按 4 行量化、ResizeObserver 同步视口, 减少滚动抖动与整表重建 - 列表页状态列改用轻量文本样式替代 el-tag,降低大列表渲染开销; 标签页缓存默认上限由 3 调整为 8 - 补充标签页性能测量结论、页面模板抽离现状与实施方案文档 --- docs/标签页性能-测量结论与执行清单.md | 408 +++++++++++++++ docs/页面模板抽离-实施方案.md | 485 +++++++++++++++++ docs/页面模板抽离-现状分析.md | 489 ++++++++++++++++++ src/components/ToolbarButtonGroup/index.vue | 414 +++++++++++++++ src/components/ToolbarButtonGroup/types.ts | 38 ++ src/components/UpperTable/index.vue | 399 ++++++++++++-- .../component/CreateOrderSessionHost.vue | 6 +- src/stores/modules/experimental.ts | 6 +- src/styles/list-page.scss | 244 +++++++++ src/styles/status-text.scss | 15 + src/utils/scanFields.ts | 19 + src/utils/statusText.ts | 28 + src/utils/storeScanOptions.ts | 73 +++ src/views/afterSale/list/index.vue | 5 +- .../components/ColumnCellRenderer.vue | 2 +- .../config/components/DetailPanel.vue | 2 +- src/views/afterSale/typelist/index.vue | 12 +- .../components/ColumnCellRenderer.vue | 7 +- .../config/components/DetailPanel.vue | 7 +- .../config/components/LogPanel.vue | 7 +- src/views/data/ordersummary/index.vue | 11 +- src/views/data/packingflow/index.vue | 5 +- .../components/ReceiveRegisterPanel.vue | 7 +- .../components/ReturnReceivedTaskPanel.vue | 4 +- src/views/express/returnReceived/index.vue | 5 +- .../components/StockPickerDialog.vue | 2 +- .../components/UnpackDetailTable.vue | 2 +- .../components/VideoListDialog.vue | 2 +- src/views/express/returnUnpack/index.vue | 5 +- src/views/express/returnUnpackwork/index.vue | 4 +- src/views/express/returnwaybill/index.vue | 5 +- .../waybill/components/ColumnCellRenderer.vue | 4 +- .../components/TransferByWaybillsDialog.vue | 2 +- .../waybill/config/components/DetailPanel.vue | 4 +- .../waybill/config/components/LogPanel.vue | 4 +- src/views/express/waybill/index.vue | 8 +- src/views/inbox/autoReply/index.vue | 3 +- src/views/inbox/group/index.vue | 5 +- src/views/inbox/message/index.vue | 5 +- src/views/material/packageMaterial/index.vue | 5 +- src/views/material/packageSupplier/index.vue | 5 +- src/views/message/index.vue | 5 +- .../mode/components/ColumnCellRenderer.vue | 6 +- .../mode/config/components/DetailPanel.vue | 6 +- src/views/mode/config/components/LogPanel.vue | 6 +- src/views/mode/index.vue | 13 +- .../order/orderManagement/archiveOrder.vue | 13 +- .../BindPackageMaterialByWaybillDialog.vue | 2 +- .../component/ExpressWaybillPanel.vue | 2 +- .../component/OrderItemsDetailPanel.vue | 2 +- .../component/OrderWorkbenchListDialog.vue | 2 +- .../component/PendingOrderDetailPanel.vue | 4 +- .../component/TransferByOrdersDialog.vue | 2 +- .../component/WorkbenchOrderDetail.vue | 2 +- .../orderManagement/component/orderdetail.vue | 2 +- .../config/order-common-config.ts | 166 ++---- .../orderManagement/deliveryException.vue | 13 +- .../order/orderManagement/deliveryOrder.vue | 13 +- .../orderManagement/entrustWarehouse.vue | 13 +- .../order/orderManagement/exceptionOrder.vue | 68 ++- .../form/BatchQuickRecheckForm.vue | 4 +- src/views/order/orderManagement/index.vue | 24 +- .../order/orderManagement/outboundOrder.vue | 13 +- .../order/orderManagement/pendingOrder.vue | 114 ++-- .../order/orderManagement/reviewOrder.vue | 56 +- .../orderManagement/styles/order-sub.scss | 259 +--------- .../order/orderManagement/utils/export.ts | 6 +- .../utils/order-page-export.ts | 4 +- .../utils/use-delivery-sub-waybill-print.ts | 2 +- .../utils/use-sub-waybill-print.ts | 2 +- .../orderWeighing/ExpressWeighingForm.vue | 2 +- src/views/order/orderWeighing/index.vue | 9 +- src/views/order/orderreview/index.vue | 7 +- .../component/OrderExportProgressDialog.vue | 0 .../component/SelectProductDialog.vue | 2 +- .../CreateOrderFloatWidget.vue | 2 +- .../CreatePendingOrderDialog.vue | 16 +- .../useCreateOrderSession.ts | 0 .../form/AllocateExpressForm.vue | 0 .../form/BatchAsyncTaskForm.vue | 0 .../form/ManualWaybillForm.vue | 0 .../form/StorageAllocateForm.vue | 0 .../form/SyncOrderIdsForm.vue | 0 .../form/UpdateAddressForm.vue | 0 .../orderListExport.ts} | 0 .../orderMetaCache.ts} | 0 .../toolbarActions.ts} | 4 +- .../waveOrder/FallbackOrderListPanel.vue | 4 +- .../waveOrder/GroupWaveBatchListPanel.vue | 5 +- .../waveOrder/SandanWaveBatchListPanel.vue | 5 +- .../order/waveOrder/WavePickTaskListPanel.vue | 5 +- .../order/waveOrder/WaveStrategyListPanel.vue | 5 +- .../component/PendingOrderListPanel.vue | 16 +- .../component/WaveBatchDetailPanel.vue | 2 +- .../order/waveOrder/config/wave-config.ts | 6 +- src/views/order/waveOrder/index.vue | 20 +- .../component/ComboGoodsFormDialog.vue | 2 +- .../component/ComboGoodsSearchDialog.vue | 2 +- .../component/ComboStockPickerDialog.vue | 2 +- src/views/stock/combo_stock/index.vue | 5 +- src/views/stock/external_stock/index.vue | 5 +- .../components/ColumnCellRenderer.vue | 4 +- src/views/stock/pickingShortage/index.vue | 6 +- .../stock/component/StockBatchEditDialog.vue | 2 +- src/views/stock/stock/index.vue | 5 +- .../utils/stockPickerHelpers.ts} | 0 .../entry/component/EntryBindingRelations.vue | 2 +- .../storage/entry/component/entrydetail.vue | 2 +- src/views/storage/entry/index.vue | 5 +- src/views/storage/entry_owner/index.vue | 5 +- src/views/storage/generalreport/index.vue | 10 +- src/views/storage/inventory/index.vue | 5 +- .../log/component/TransactionDetail.vue | 2 +- src/views/storage/log/index.vue | 5 +- .../management/replenishmentDemand/index.vue | 2 +- .../component/ProductflowDetail.vue | 2 +- src/views/storage/productflow/index.vue | 7 +- src/views/storage/productflow/store/index.vue | 7 +- .../storage/receiving/component/Product.vue | 4 +- src/views/storage/receiving/index.vue | 5 +- src/views/storage/receiving_owner/index.vue | 5 +- src/views/storage/report/index.vue | 2 +- src/views/storage/report/store.vue | 2 +- .../components/ColumnCellRenderer.vue | 6 +- .../config/components/CheckItemsPanel.vue | 6 +- .../config/components/CheckRecordsPanel.vue | 6 +- .../config/components/DetailPanel.vue | 6 +- .../stockcheck/config/components/LogPanel.vue | 6 +- src/views/storage/stockcheck/index.vue | 10 +- src/views/storage/stockout/index.vue | 5 +- src/views/store/shipperSigning/index.vue | 5 +- src/views/store/stores/index.vue | 5 +- src/views/system/setting/account/index.vue | 7 +- .../newview/components/ColumnCellRenderer.vue | 4 +- .../newview/config/components/DetailPanel.vue | 6 +- .../newview/config/components/LogPanel.vue | 4 +- .../setting/basicManagement/newview/index.vue | 13 +- .../components/CourierCodeManagement.vue | 2 +- .../components/PlatformCodeManagement.vue | 2 +- .../system/setting/expressinterface/index.vue | 4 +- src/views/system/setting/permission/index.vue | 5 +- .../setting/pickcart/components/InfoPanel.vue | 2 +- src/views/system/setting/pickcart/index.vue | 5 +- .../printStation/components/Printer.vue | 2 +- .../printStation/components/printComputer.vue | 2 +- .../system/setting/printStation/index.vue | 2 +- .../components/ColumnCellRenderer.vue | 4 +- .../config/components/DetailPanel.vue | 4 +- .../config/components/LogPanel.vue | 4 +- .../system/setting/printcomputer/index.vue | 4 +- .../role/components/ColumnCellRenderer.vue | 6 +- src/views/system/setting/role/index.vue | 8 +- .../role/pages/RolePermissionDialog.vue | 2 +- src/views/system/setting/shops/index.vue | 5 +- .../storeExpressBindingPolicy/index.vue | 5 +- .../components/ColumnCellRenderer.vue | 4 +- .../config/components/DetailPanel.vue | 4 +- .../workbench2/config/components/LogPanel.vue | 4 +- src/views/system/setting/workbench2/index.vue | 9 +- src/views/test/index.vue | 16 +- .../components/ColumnCellRenderer.vue | 2 +- .../config/components/DetailPanel.vue | 2 +- .../newcamara/config/components/LogPanel.vue | 2 +- src/views/video/newcamara/index.vue | 4 +- .../components/ColumnCellRenderer.vue | 2 +- .../config/components/DetailPanel.vue | 2 +- .../config/components/LogPanel.vue | 2 +- src/views/video/newcamaraserver/index.vue | 4 +- src/views/warehouses/index.vue | 5 +- 169 files changed, 3187 insertions(+), 834 deletions(-) create mode 100644 docs/标签页性能-测量结论与执行清单.md create mode 100644 docs/页面模板抽离-实施方案.md create mode 100644 docs/页面模板抽离-现状分析.md create mode 100644 src/components/ToolbarButtonGroup/index.vue create mode 100644 src/components/ToolbarButtonGroup/types.ts create mode 100644 src/styles/list-page.scss create mode 100644 src/styles/status-text.scss create mode 100644 src/utils/scanFields.ts create mode 100644 src/utils/statusText.ts create mode 100644 src/utils/storeScanOptions.ts rename src/views/order/{orderManagement => shared}/component/OrderExportProgressDialog.vue (100%) rename src/views/order/{orderManagement => shared}/component/SelectProductDialog.vue (99%) rename src/views/order/{orderManagement/component => shared/createOrderSession}/CreateOrderFloatWidget.vue (98%) rename src/views/order/{orderManagement/component => shared/createOrderSession}/CreatePendingOrderDialog.vue (99%) rename src/views/order/{orderManagement/composables => shared/createOrderSession}/useCreateOrderSession.ts (100%) rename src/views/order/{orderManagement => shared}/form/AllocateExpressForm.vue (100%) rename src/views/order/{orderManagement => shared}/form/BatchAsyncTaskForm.vue (100%) rename src/views/order/{orderManagement => shared}/form/ManualWaybillForm.vue (100%) rename src/views/order/{orderManagement => shared}/form/StorageAllocateForm.vue (100%) rename src/views/order/{orderManagement => shared}/form/SyncOrderIdsForm.vue (100%) rename src/views/order/{orderManagement => shared}/form/UpdateAddressForm.vue (100%) rename src/views/order/{orderManagement/utils/order-index-helpers.ts => shared/orderListExport.ts} (100%) rename src/views/order/{orderManagement/utils/order-meta-cache.ts => shared/orderMetaCache.ts} (100%) rename src/views/order/{orderManagement/utils/toolbar-actions.ts => shared/toolbarActions.ts} (99%) rename src/views/{order/orderManagement/utils/stock-picker-helpers.ts => stock/utils/stockPickerHelpers.ts} (100%) diff --git a/docs/标签页性能-测量结论与执行清单.md b/docs/标签页性能-测量结论与执行清单.md new file mode 100644 index 00000000..2a7d325b --- /dev/null +++ b/docs/标签页性能-测量结论与执行清单.md @@ -0,0 +1,408 @@ +# 标签页性能 · 测量结论与执行清单 + +> 测量对象:`http://localhost:5174/order/orderManagement`(dev server,硬刷新) +> 测量工具:浏览器工具 + `PerformanceObserver(longtask/LCP/CLS)` + CDP `Performance.getMetrics` + CDP `Profiler` +> 测量日期:2026-11-06 +> **本文档只做结论与清单,未改动任何代码。** + +--- + +## 0. 口径说明(先读) + +| 项 | 说明 | +|---|---| +| 环境 | Vite **dev server**(ESM 按模块加载,未打包) | +| 是否限速 | 否(无 CPU/网络节流) | +| "切 tab 耗时"口径 | 从点击到 `.main-container` **连续 350–400ms 无 DOM 变更**。因此数值里**包含约 350–400ms 的静默判定窗口**,绝对值偏高,**只看相对差异** | +| 生产环境差异 | dev 下 246 个 script 请求 / 14.17MB 解码体积,生产打包后会大幅下降;**但"8 个 tab 页被静态 import 进同一路由块"这个结构性问题在生产同样存在** | + +--- + +## 1. 首屏测量结果 + +### 1.1 关键时间点 + +| 指标 | 数值 | 说明 | +|---|---|---| +| TTFB | **314 ms** | 后端首字节 | +| FCP | **576 ms** | 首次内容绘制 | +| DOMContentLoaded | **748 ms** | | +| load | **750 ms** | | +| **LCP** | **3392 ms** | 列表内容出现晚 | +| CLS | 0.029 | 轻微布局抖动 | +| **最长任务** | **1857 ms**(起始 1272 ms) | 主线程被独占近 2 秒 | +| **TBT(总阻塞时间)** | **2333 ms** | 远高于 300ms 良好线 | +| 其它长任务 | 358ms@3317、135ms@3131、90ms@658、63ms@3676 | | + +> 时间线:576ms 首屏骨架 → 1272ms 起一个 1.86s 长任务(页面"卡住")→ 3129ms 结束 → 3392ms 才画出列表内容。**用户体感的"打开慢"就是这一段。** + +### 1.2 资源与 DOM + +| 指标 | 数值 | +|---|---| +| 请求总数 | **250**(script 246 / css 1 / xhr 3) | +| 脚本解码体积 | **14.17 MB**(transfer 仅 0.09MB,本地 dev) | +| `views/order/orderManagement/` 下的模块 | **69 个**(一次性全部加载) | +| DOM 元素(`querySelectorAll('*')`) | **7537** | +| CDP `Nodes` | **22260** | +| 首屏表格实际行数 | 20 | + +**关键事实**:打开 orderManagement 时,**8 个 tab 页(review/pending/exception/outbound/entrust/delivery/deliveryException/archive)及其依赖的 api 模块被一次性加载**(`index.vue:104-113` 全是静态 import + `markRaw`)。这是 1.86s 长任务的主要来源。 + +### 1.3 CPU 采样归因(7 秒窗口) + +| 分类 | 耗时 | +|---|---| +| idle(空闲) | 3077 ms | +| **program(解析/编译/样式/布局/绘制等浏览器内部)** | **1336 ms** | +| garbage collector | 156 ms | +| 最高的单个 JS 帧 | `update2 @ element-plus` 91 ms | +| 其次 | `track`(响应式) 67ms、`getBoundingClientRect` 59ms、`createReactiveObject` 54ms | + +**结论**:长任务**不是某一段业务 JS 卡住**,而是"大量模块解析 + 大 DOM 样式/布局"的累计。因此优化方向是**减少首屏要加载/渲染的量**,而不是找某个函数优化。 + +### 1.4 首屏的其它噪声 + +- 8 个 WebSocket 连接失败:`ws://127.0.0.1:13888 / 5000 / 16888 / 10818 / 9113 / 12705 / 13528 / 8000` 全部 `ERR_CONNECTION_REFUSED`(打印组件、摄像头等本地服务)。 +- 它们在 load 之后异步触发,**不直接阻塞首屏**,但会刷错误、占用连接池、增加控制台噪声。 + +--- + +## 2. 切 tab 测量结果(核心证据) + +### 2.1 依次访问 5 个 tab(`tabCacheMax = 3`,共 8 个 tab) + +| 顺序 | tab | 耗时 | 期间长任务 | +|---|---|---|---| +| 1 | 待处理异常订单(首次) | **2006 ms** | 938ms | +| 2 | 待出库订单(首次) | **1628 ms** | 879ms | +| 3 | 委托外仓订单(首次) | **1313 ms** | 630ms | +| 4 | 配送订单(首次) | **2088 ms** | 1083ms | +| 5 | **回到**待处理异常订单 | **3075 ms** | 1199 + 763 + 636ms | + +> 第 5 次比第 1 次**还慢 1 秒**。这就是 `KeepAlive :max="3"` 小于 8 个 tab 带来的 **LRU 抖动**:第 1 个 tab 早已被淘汰,回来时要重新挂载;同时缓存里还占着 3 个旧组件,内存压力更大。 + +### 2.2 两个 tab 之间往返(都在缓存内) + +| 顺序 | tab | 耗时 | +|---|---|---| +| A1 | 待出库订单(首次挂载) | 1696 ms | +| B1 | 委托外仓订单(首次挂载) | 1548 ms | +| **A2** | 待出库订单(**缓存命中**) | **649 ms** | +| **B2** | 委托外仓订单(**缓存命中**) | **642 ms** | +| **A3** | 待出库订单(**缓存命中**) | **691 ms** | + +**结论:缓存命中确实有效(1.6s → 0.65s,约 2.5 倍)**,但: + +- 0.65s 里包含 350–400ms 的静默判定窗口; +- 而 **CSS 过渡本身固定占约 400ms**(`mode="out-in"` + 0.2s 淡出 + 0.2s 淡入)。 + +也就是说:**缓存命中时,"CSS 动画时长"已经成了主要成本**,与数据加载无关。 + +### 2.3 内存 + +访问多个 tab 后:`performance.memory.usedJSHeapSize ≈ 216 MB`,DOM 仍 7105 元素。 +(对照:刚首屏时 CDP `JSHeapUsedSize` 约 68 MB) + +> 这解释了为什么第 5 次切回会触发 3 个长任务:**重建 + GC**。 + +--- + +## 3. 结论:慢在哪 + +| # | 原因 | 证据 | 影响面 | +|---|---|---|---| +| **C1** | 8 个 tab 页被静态 import,打开即加载 69 个模块 | 250 请求 / 14.17MB / 长任务 1857ms | 首屏 | +| **C2** | 首屏 DOM 2.2 万节点、样式与布局耗时 1336ms | `program` 1336ms、DOM 7537 | 首屏 | +| **C3** | `tabCacheMax=3` < tab 数(8 / 5)→ LRU 抖动 | 第 5 次切回 3075ms > 首次 2006ms | 切 tab | +| **C4** | 过渡动画固定 400ms | 缓存命中仍 0.65s | 切 tab(缓存命中时是主成本) | +| **C5** | 提高缓存后缺少"释放/刷新"配套(见代码) | 各 tab 只在 `onBeforeUnmount` 清理;无 `onActivated` | 提高缓存后暴露 | +| **C6** | 8 个本地 WebSocket 连接失败 | 控制台 8 条 ERR_CONNECTION_REFUSED | 噪声/次要 | + +--- + +## 4. 执行清单 + +> 每项都标了**为什么做(对应哪条证据)**、改动位置、验收标准。 +> 建议按批次执行,批次 1+2 必须成对上线。 + +### 批次 1 · 修缓存策略(P0) + +| # | 事项 | 位置 | 依据 | +|---|---|---|---| +| 1.1 | `tabCacheMax` 默认值 3 → **8**(或按页面 tab 数取最大) | `src/stores/modules/experimental.ts`(`DEFAULT_TAB_CACHE_MAX`) | C3 | +| 1.2 | 支持按页面覆盖缓存上限:`ORDER_PAGE_CONFIG.tabCacheMax`、`WAVE_PAGE_CONFIG.tabCacheMax` | `orderManagement/config/order-common-config.ts`、`waveOrder/config/wave-config.ts` + 两个 `index.vue` | C3(8 tab / 5 tab 需求不同) | +| 1.3 | KeepAlive 内 `:key` 统一为 `:key="activeTab"` | `orderManagement/index.vue:56-59`(当前**没有** key)、`waveOrder/index.vue:74-80` | 避免不同 tab 复用同组件类型时串数据 | +| 1.4 | 单页模式 `` 补 `:max` | `waveOrder/index.vue:93-99` | 与多页模式策略一致 | + +**验收**:`A→B→A` 往返时第二次耗时 ≤ 首次的 50%(当前 1.6s → 0.65s 已达标,改后应同样稳定);8 个 tab 依次访问后回到第 1 个,耗时不再高于首次。 + +--- + +### 批次 2 · 缓存的"配套"(P0,必须与批次 1 同批) + +| # | 事项 | 位置 | 依据 | +|---|---|---|---| +| 2.1 | 切走的 tab 释放大列表:`useOrderListPageCleanup` 从 `onBeforeUnmount` 扩展到 `onDeactivated` | `orderManagement/utils/use-order-list-page-cleanup.ts` + 3 个列表 tab | C5(否则 8 份大列表常驻,实测 216MB) | +| 2.2 | 建单成功回调总线防放大:只让**当前激活 tab** 立刻 `loadData`,其它 tab 打 `dirty` 标记 | `pendingOrder.vue:574`、`exceptionOrder.vue:655`、`reviewOrder.vue:283`(`registerCreateOrderSuccess`) | C5(8 个 tab 全部注册在册 → 一次建单触发 8 次请求) | +| 2.3 | 补 `onActivated` 刷新策略:`dirty` 优先,其次 `lastLoadedAt + 阈值` | 同上 3 个列表 tab | C5(当前缓存后切回永远是旧数据) | +| 2.4 | 交付时明确"全局开关仍是总闸" | `experimental.ts` | 保留回滚能力 | + +**验收**: +- 建单成功 → Network 里**只有 1 个** list 请求; +- 在别的菜单改数据后切回 → 最终一致; +- 访问 5 个 tab 后内存增量 ≤ 100MB(当前 216MB)。 + +--- + +### 批次 3 · 首屏模块拆分(P0) + +| # | 事项 | 位置 | 依据 | +|---|---|---|---| +| 3.1 | 8 个 tab 组件改为**按需加载**:`defineAsyncComponent(() => import('./pendingOrder.vue'))` | `orderManagement/index.vue:104-113` | C1(首屏一次性拉 69 个模块) | +| 3.2 | 首屏默认 tab 保持同步或预加载(避免首屏多一次 chunk 等待) | 同上 | 平衡 | +| 3.3 | `waveOrder` 同样处理 | `waveOrder/index.vue` 顶部 import | C1 | +| 3.4 | 校验分包产物:路由 chunk 体积下降、各 tab 独立 chunk | `npm run build` 输出 | C1 | + +**预期**:首屏加载的 `orderManagement` 模块 69 → 约 10(仅激活 tab 及其依赖),长任务显著下降。 + +**验收**:首屏 LCP 下降;首次切到未访问 tab 允许有一次 chunk 等待(≤200ms 内网)。 + +> ⚠️ 3.1 会让"首次切某个 tab"多一次网络请求。**必须与批次 1 一起评估**:有缓存上限后,每个 tab 只会懒加载一次。 + +--- + +### 批次 4 · 过渡动画(P1) + +| # | 事项 | 位置 | 依据 | +|---|---|---|---| +| 4.1 | `tab-fade` 从 `0.2s` 降到 `0.12s`(或缓存命中时跳过 `out-in`) | 各容器 ` + + diff --git a/src/components/ToolbarButtonGroup/types.ts b/src/components/ToolbarButtonGroup/types.ts new file mode 100644 index 00000000..f3c6a5db --- /dev/null +++ b/src/components/ToolbarButtonGroup/types.ts @@ -0,0 +1,38 @@ +/** + * 工具栏按钮组配置类型 + * + * 从 `views/order/orderManagement/config/order-common-config.ts` 抽离, + * 供 `@/components/ToolbarButtonGroup` 与各页面 `*-config.ts` 共用。 + */ + +export interface ToolbarButtonConfig { + key: string + label: string + dynamicLabelKey?: string + size?: '' | 'default' | 'small' | 'large' + type?: '' | 'primary' | 'success' | 'warning' | 'info' | 'danger' + plain?: boolean + loadingKey?: string + disabledKey?: string + action: string + /** 按钮样式分类(优先级高于 type/plain): + * 'refresh' - 蓝底白字(primary) + * 'setting' - 白底黑字(default) + * 'action' - 白底蓝边框蓝字(primary + plain) + * 'cancel' - 红底白字(danger) + * 不设置则沿用 type/plain */ + category?: 'refresh' | 'setting' | 'action' | 'cancel' + /** 下拉按钮:主按钮点击 action,菜单项使用 dropdownOptions[].action */ + buttonType?: 'default' | 'dropdown' + dropdownOptions?: Array<{ label: string; action: string; divided?: boolean }> +} + +export interface ToolbarApiActionConfig { + action: string + apiMethod: string + payloadKey?: string + confirmText?: string + confirmType?: 'warning' | 'error' | 'info' | 'success' + successText: string + failText: string +} diff --git a/src/components/UpperTable/index.vue b/src/components/UpperTable/index.vue index e0c3caa6..8337f59b 100644 --- a/src/components/UpperTable/index.vue +++ b/src/components/UpperTable/index.vue @@ -1,5 +1,5 @@