perf(frontend): 工具页分页/历史截断/轻量轮询/共享纯逻辑(审查 F5/F6/F9/F12/G3)
- F9 新增 useTablePaging composable 并接入 7 个工具页"匹配结果"表(只切渲染窗口, 不加选择语义;每页 100 条)+ 深色分页样式 - F6 历史任务抽屉渲染截断(默认 50 条 + "显示全部/收起"),全选口径改为当前可见条目 - F5 新增 task-progress-polling 适配器:等待任务终态的紧循环走 /tasks/progress/light, 异常或空响应回退重型 batch;已接入跟价/定时匹配的 waitForTaskTerminal - F12 背景图 bg.jpg 251KB → 166KB(1920 宽 + quality 80,image-set 仍优先 webp) - G3 抽出共享纯逻辑 task-queue-state(开始时间表序列化校验 + 记录缺失错误判定), 5 个工具页删除逐字重复实现 - 新增 4 个单测文件(分页切片/历史截断/轻量轮询归一/任务队列纯逻辑)
This commit is contained in:
@@ -0,0 +1,62 @@
|
||||
import { computed, ref, watch, type ComputedRef, type Ref } from 'vue'
|
||||
|
||||
/**
|
||||
* 表格分页(2026-09 全维度审查 F9)。
|
||||
*
|
||||
* 工具页的"匹配结果"表此前把整份数据绑到 el-table 的 :data 上,全量行常驻 DOM
|
||||
* (每行 8+ 节点,几百行就会明显拖慢打开/滚动)。这里提供共用的分页切片:
|
||||
* 只改变渲染的数据窗口,不改动数据源本身,因此挑选/删除/提交等逻辑不受影响。
|
||||
*/
|
||||
|
||||
/** 默认每页条数:足够一屏展示,又不会让 DOM 随列表规模线性膨胀。 */
|
||||
export const DEFAULT_TABLE_PAGE_SIZE = 100
|
||||
|
||||
/** 纯函数切片:page 从 1 开始,越界自动收敛到有效范围。 */
|
||||
export function paginateSlice<T>(items: T[] | null | undefined, page: number, pageSize: number): T[] {
|
||||
const list = Array.isArray(items) ? items : []
|
||||
const size = Number.isFinite(pageSize) && pageSize > 0 ? Math.floor(pageSize) : DEFAULT_TABLE_PAGE_SIZE
|
||||
const pageCount = Math.max(1, Math.ceil(list.length / size))
|
||||
const safePage = Math.min(Math.max(1, Math.floor(Number.isFinite(page) ? page : 1)), pageCount)
|
||||
const start = (safePage - 1) * size
|
||||
return list.slice(start, start + size)
|
||||
}
|
||||
|
||||
/** 有效页码(把越界页码收敛到 [1, pageCount])。 */
|
||||
export function clampPage(page: number, total: number, pageSize: number): number {
|
||||
const size = Number.isFinite(pageSize) && pageSize > 0 ? Math.floor(pageSize) : DEFAULT_TABLE_PAGE_SIZE
|
||||
const pageCount = Math.max(1, Math.ceil((Number.isFinite(total) ? total : 0) / size))
|
||||
return Math.min(Math.max(1, Math.floor(Number.isFinite(page) ? page : 1)), pageCount)
|
||||
}
|
||||
|
||||
export interface TablePaging<T> {
|
||||
/** 当前页码(可 v-model:current-page 绑定) */
|
||||
page: Ref<number>
|
||||
/** 每页条数 */
|
||||
pageSize: number
|
||||
/** 数据总条数 */
|
||||
total: ComputedRef<number>
|
||||
/** 当前页数据(绑定到 el-table 的 :data) */
|
||||
paged: ComputedRef<T[]>
|
||||
}
|
||||
|
||||
/**
|
||||
* 基于响应式数据源的分页状态。数据源变化(新增/删除行)时自动收敛页码,
|
||||
* 避免删到空页后表格显示空白且无法回到有效页。
|
||||
*/
|
||||
export function useTablePaging<T>(
|
||||
source: Ref<T[]> | ComputedRef<T[]>,
|
||||
pageSize: number = DEFAULT_TABLE_PAGE_SIZE,
|
||||
): TablePaging<T> {
|
||||
const page = ref(1)
|
||||
const total = computed(() => (Array.isArray(source.value) ? source.value.length : 0))
|
||||
const paged = computed(() => paginateSlice(source.value, page.value, pageSize))
|
||||
|
||||
watch([total, () => pageSize], () => {
|
||||
const next = clampPage(page.value, total.value, pageSize)
|
||||
if (next !== page.value) {
|
||||
page.value = next
|
||||
}
|
||||
})
|
||||
|
||||
return { page, pageSize, total, paged }
|
||||
}
|
||||
Reference in New Issue
Block a user