WEB/src/views/order/orderManagement/deliveryException.vue
yin 3b09d45f08 refactor(list): 抽离列表页公共模板与共享工具,优化虚拟滚动与状态渲染
- 新增 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
- 补充标签页性能测量结论、页面模板抽离现状与实施方案文档
2026-11-06 18:01:24 +08:00

438 lines
14 KiB
Vue
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<template>
<div class="order-sub-container">
<scan-box
ref="scanBox"
cache-key="orderManagement:deliveryException"
width="220px"
:tree-props="{ children: 'children', label: 'label' }"
:auto-submit="false"
:preset-tree="presetTree"
:available-fields="availableFieldsRef"
@condition-change="handleConditionChange"
@reset="handleConditionReset"
@condition-clear="handleConditionClear"
/>
<div class="main-content">
<div class="toolbar">
<div class="toolbar-left">
<order-toolbar-button-group
:buttons="toolbarButtons"
:resolve-disabled="resolveButtonDisabled"
:resolve-loading="resolveButtonLoading"
:resolve-label="resolveButtonLabel"
:layout-key="toolbarLayoutKey"
@action="handleToolbarButtonClick"
/>
</div>
<!-- 已迁移至 ScanBox:搜索订单号 -->
<!-- <div class="toolbar-right">
<el-input size="small" placeholder="搜索订单号" v-model="quickSearch" style="width:220px" @keyup.enter.native="onQuickSearch" />
</div> -->
</div>
<div class="split-stack" ref="splitStackRef">
<div class="upper-wrapper" :style="detailVisible ? upperPaneStyle : upperPaneFullStyle">
<upper-table
ref="upperTable"
title="配送异常列表"
default-align="center"
:enable-column-config="true"
table-id="order-management-delivery-exception"
:data="list"
:columns="columns"
:table-size="tableSize"
:pagination="pagination"
:show-index="true"
:show-actions="true"
:show-selection="true"
:loading="loading"
:queryTime="queryTime"
@current-change="handleRowClick"
@page-change="handlePageChange"
@page-size-change="handlePageSizeChange"
@refresh="loadData"
@selection-change="onSelectionChange"
>
<template #column-order_status="{ row }">
<span :class="getStatusTextClass(getTagType('order_status', row.order_status))">
{{ translateOrderField('order_status', row.order_status) }}
</span>
</template>
<template #column-status="{ row }">
<span :class="getStatusTextClass(getTagType('status', row.status))">
{{ translateOrderField('status', row.status) }}
</span>
</template>
<template #empty>
<div class="empty-tip">暂无配送异常</div>
</template>
</upper-table>
</div>
<template v-if="detailVisible">
<div class="pane-resizer" title="拖动调整列表与详情区域高度" @mousedown="beginSplitDrag" />
<div class="lower-level" v-if="selectedOrderId" :class="tableSize" :style="lowerPaneStyle">
<div class="detail-header">
<el-tabs v-model="activeTab" class="detail-tab">
<el-tab-pane label="订单明细" name="detail" />
<el-tab-pane label="商品明细" name="items" />
<el-tab-pane label="履约记录" name="fulfillment" />
<el-tab-pane label="订单日志" name="logs" />
</el-tabs>
</div>
<div class="detail-container">
<div v-if="activeTab === 'detail'" :key="`detail-${selectedOrderId}`" class="detail-page order-detail-wrapper">
<pending-order-detail-panel :key="selectedOrderId" :row="selectedRow" :detail-request="fetchDeliveryExpectionOrderDetail" />
</div>
<div v-else-if="activeTab === 'items'" :key="`items-${selectedOrderId}`" class="detail-page order-detail-wrapper">
<order-items-detail-panel :key="selectedOrderId" :row="selectedRow" :detail-request="fetchDeliveryExpectionOrderDetail" />
</div>
<div v-else-if="activeTab === 'fulfillment'" class="detail-page">
<p>履约历程加载中...</p>
</div>
<div v-else :key="`logs-${selectedOrderId}`" class="detail-page order-log-wrapper">
<log :key="selectedOrderId" :data="selectedRow" />
</div>
</div>
</div>
<div class="no-selection" v-else :style="lowerPaneStyle">
<div class="empty-tip">
<p>请从上方列表中选择一项查看详情</p>
</div>
</div>
</template>
</div>
</div>
<order-export-columns-dialog
v-model:visible="exportColumnsDialogVisible"
:mode="exportColumnsMode"
:loading="exportColumnsLoading"
:storage-key="exportColumnsStorageKey"
:scope="exportColumnsScope"
@confirm="confirmExportColumns"
/>
<order-export-progress-dialog
v-model:visible="exportDialogVisible"
:loading="exportLoading"
:progress-percent="exportProgressPercent"
:progress-status="exportProgressStatus"
:status-label="exportStatusLabel"
:task-id="exportTaskProgress.taskId"
:message="exportTaskProgress.message"
:error="exportTaskProgress.error"
:meta="exportTaskProgress"
/>
</div>
</template>
<script setup lang="ts">
import { ref, reactive, onMounted, computed } from 'vue'
import { ElMessage } from 'element-plus'
import ScanBox from '@/components/ScanBox/index.vue'
import UpperTable from '@/components/UpperTable/index.vue'
import { loadExpressListCached, loadStoresCached } from '@/views/order/shared/orderMetaCache'
import { orderDeliveryExpectionOrder } from '@/api/order.deliveryexpectionorder/orderdeliveryexpectionorder'
import {
archiveAvailableFields,
archiveColumns,
deliveryExceptionToolbarButtons,
type ToolbarButtonConfig,
translateOrderField,
getTagType,
getStatusTextClass,
fillExpressCompanyScanFieldOptions,
fillStoreScanFieldOptions,
extractStoreListFromResponse
} from './config/order-common-config'
import PendingOrderDetailPanel from './component/PendingOrderDetailPanel.vue'
import OrderItemsDetailPanel from './component/OrderItemsDetailPanel.vue'
import log from './component/log.vue'
import OrderExportProgressDialog from '@/views/order/shared/component/OrderExportProgressDialog.vue'
import OrderExportColumnsDialog from './component/OrderExportColumnsDialog.vue'
import { createOrderPageExport } from './utils/order-page-export'
import { buildOrderWhereConditions, parseOrderListResponse } from '@/views/order/shared/orderListExport'
import { useOrderListPageCleanup } from './utils/use-order-list-page-cleanup'
import { useVerticalSplitPane } from '@/composables/useVerticalSplitPane'
import OrderToolbarButtonGroup from '@/components/ToolbarButtonGroup/index.vue'
import { createSimpleListToolbarController } from '@/views/order/shared/toolbarActions'
import { safeInvoke } from '@/utils/safe-invoke'
const scanBox = ref<any>(null)
const upperTable = ref<any>(null)
const presetTree = ref<any[]>([])
const availableFieldsRef = reactive(JSON.parse(JSON.stringify(archiveAvailableFields)))
const activeTab = ref('detail')
const list = ref<any[]>([])
const loading = ref(false)
const queryTime = ref(0)
const pagination = reactive({ currentPage: 1, pageSize: 20, total: 0 })
const tableSize = ref('small')
const columns = ref(archiveColumns)
const selectionRows = ref<any[]>([])
const hasSelection = ref(false)
const selectedOrderId = ref<number | string | null>(null)
const detailVisible = ref(true)
const toolbarButtons = deliveryExceptionToolbarButtons
const selectedRow = computed(() => {
return list.value.find((i: any) => i.id === selectedOrderId.value) || null
})
/** order.deliveryExpectionOrder.list:where 禁止传入 warehouse_id / warehouseId */
function sanitizeDeliveryExpectionListWhere(where: Record<string, any>) {
const w = { ...where }
delete w.warehouse_id
delete w.warehouseId
return w
}
/** order.deliveryExpectionOrder.detail:配送异常 dispatch 模型 */
function fetchDeliveryExpectionOrderDetail(data: Record<string, any>) {
return orderDeliveryExpectionOrder.detail({
...data,
tableType: 'dispatch'
})
}
const { splitStackRef, beginSplitDrag, lowerPaneStyle, upperPaneStyle } = useVerticalSplitPane({
defaultLowerPercent: 38
})
const upperPaneFullStyle = computed(() => ({
flex: '1 1 auto',
minHeight: '0',
overflow: 'hidden'
}))
function toggleDetailVisible() {
detailVisible.value = !detailVisible.value
}
function translateField(fieldValue: string, value: any) {
const field = availableFieldsRef.find((f: any) => f.value === fieldValue)
if (field && field.options) {
const option = field.options.find((opt: any) => opt.value === value)
return option ? option.label : value
}
return value
}
onMounted(() => {
loadData()
loadFilterData()
})
useOrderListPageCleanup({ list, selectionRows, selectedOrderId })
async function loadData() {
if (loading.value) return
loading.value = true
const start = Date.now()
try {
const params = {
pagination: {
page: pagination.currentPage,
pageSize: pagination.pageSize
},
where: buildWhere(),
sort: {
sortField: 'updated_at',
sortOrder: 'DESC' as const
}
}
const res: any = await orderDeliveryExpectionOrder.list(params)
if (res && (res.code === 200 || res.code === 1)) {
const data = parseOrderListResponse(res)
list.value = data.list
pagination.total = data.total
} else {
list.value = []
pagination.total = 0
}
} catch (e) {
list.value = []
pagination.total = 0
ElMessage.error('获取配送异常订单列表失败')
} finally {
loading.value = false
queryTime.value = Date.now() - start
}
}
function buildWhere() {
const where = buildOrderWhereConditions(scanBox.value?.getConditions?.() || {})
return sanitizeDeliveryExpectionListWhere(where)
}
const pageExport = createOrderPageExport({
scopeKey: 'deliveryException',
buildWhere,
buildSort: () => ({
sortField: 'updated_at',
sortOrder: 'DESC'
}),
selectionRows,
columns,
fileNamePrefix: '配送异常',
storageKey: 'orderManagement:deliveryException:exportTaskId'
})
const {
exportLoading,
exportSelectionLoading,
exportDialogVisible,
exportTaskProgress,
exportProgressPercent,
exportProgressStatus,
exportStatusLabel,
handleExport,
handleExportWaybill,
handleExportItem,
handleExportSelection,
handleExportSelectionWaybill,
handleExportSelectionItem,
exportColumnsDialogVisible,
exportColumnsMode,
exportColumnsLoading,
exportColumnsStorageKey,
exportColumnsScope,
confirmExportColumns
} = pageExport
async function loadFilterData() {
try {
const [storesRes, expressRes]: any = await Promise.all([
loadStoresCached(),
loadExpressListCached({ systemOnly: 'true' })
])
fillStoreScanFieldOptions(availableFieldsRef, extractStoreListFromResponse(storesRes))
const expressData: any = expressRes?.data
const expressRaw = expressData?.list || expressData || []
fillExpressCompanyScanFieldOptions(availableFieldsRef, expressRaw)
} catch (e) {
fillStoreScanFieldOptions(availableFieldsRef, [])
fillExpressCompanyScanFieldOptions(availableFieldsRef, [])
}
}
function handleConditionChange() {
pagination.currentPage = 1
loadData()
}
function handleConditionClear() {
pagination.currentPage = 1
loadData()
}
function handleConditionReset() {
pagination.currentPage = 1
scanBox.value?.reset?.()
loadData()
}
function onSelectionChange(rows: any[]) {
selectionRows.value = rows || []
hasSelection.value = selectionRows.value.length > 0
}
function handleRowClick(row: any) {
selectedOrderId.value = row?.id || null
}
function handlePageChange(page: number) {
pagination.currentPage = page
loadData()
}
function handlePageSizeChange(size: number) {
pagination.pageSize = size
pagination.currentPage = 1
loadData()
}
function openColumnConfigPanel() {
upperTable.value?.openColumnConfig?.()
}
const buttonLoadingMap = computed<Record<string, boolean>>(() => ({
exportLoading: exportLoading.value,
exportSelectionLoading: exportSelectionLoading.value
}))
const buttonDisabledMap = computed<Record<string, boolean>>(() => ({
hasNoSelection: selectionRows.value.length === 0
}))
const buttonLabelMap = computed<Record<string, string>>(() => ({
detailToggleLabel: detailVisible.value ? '隐藏详情' : '显示详情'
}))
const toolbarLayoutKey = computed(() =>
JSON.stringify({
loading: buttonLoadingMap.value,
disabled: buttonDisabledMap.value,
labels: buttonLabelMap.value
})
)
const { actionMap: toolbarActionMap } = createSimpleListToolbarController({
loadData,
handleExport,
handleExportWaybill,
handleExportItem,
handleExportSelection,
handleExportSelectionWaybill,
handleExportSelectionItem,
openColumnConfigPanel,
toggleDetailVisible
})
function resolveButtonLoading(loadingKey?: string) {
if (!loadingKey) return false
return Boolean(buttonLoadingMap.value[loadingKey])
}
function resolveButtonDisabled(disabledKey?: string) {
if (!disabledKey) return false
return Boolean(buttonDisabledMap.value[disabledKey])
}
function resolveButtonLabel(defaultLabel: string, dynamicLabelKey?: string) {
if (!dynamicLabelKey) return defaultLabel
return buttonLabelMap.value[dynamicLabelKey] || defaultLabel
}
function handleToolbarButtonClick(action: ToolbarButtonConfig['action']) {
const handler = toolbarActionMap[action]
if (!handler) return
safeInvoke(() => handler())
}
</script>
<style scoped lang="scss">
@use "@/styles/list-page.scss";
@use "@/styles/status-text.scss";
/* 详情区外壳只保留左右 10px(订单明细/商品明细/订单日志面板自带 padding: 6px 10px 8px),
与 stock/external_stock 各面板保持一致 */
.order-sub-container .main-content .lower-level .detail-container {
padding: 0 10px;
}
</style>