oms/frontend/src/composables/useListPage.ts
liufumingren b946d09a03 style(frontend): 列表表格改为表体内部滚动,分页默认 20 条
- 各列表 el-table/DataTable 传 height="100%",让表头固定、表体滚动
  (原先只写了 CSS height,Element Plus 不会生成内部滚动容器,行多时被父容器裁掉)
- 每页条数选项改为 20/50/100/200,默认 20;移除硬编码的 10 条/页
  (外打平台商家列表、店铺商品绑定弹窗、商品选择弹窗统一走 DEFAULT_PAGE_SIZE)
- 清理因此失效的 .fill-table 样式

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-03 03:29:15 +08:00

94 lines
2.6 KiB
TypeScript
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.

import { ref, type Ref } from 'vue'
/** 每页条数下拉可选项(不再提供 10 条/页) */
export const PAGE_SIZES = [20, 50, 100, 200]
/** 默认每页条数 */
export const DEFAULT_PAGE_SIZE = 20
/** 分页查询条件:各列表页的 query 至少要含 page / pageSize */
export interface PageQuery {
page: number
pageSize: number
}
/** 列表接口统一返回结构 */
export interface PageResult<T> {
list: T[]
total: number
page?: number
pageSize?: number
}
/** useListPage 的入参 */
export interface UseListPageOptions<T, Q extends PageQuery> {
/** 列表页自己的查询条件(含 page / pageSize),组合式函数会直接修改其中的分页字段 */
query: Q
/** 拉取数据的方法:内部读取 query 上的 page / pageSize 传给后端 */
fetcher: () => Promise<PageResult<T>>
}
/**
* 列表分页封装
* - 统一维护 loading / list / total,列表页不再各写一套
* - 统一分页交互语义:条件查询回到第一页;切换页码按页拉取;切换每页条数回到第一页再拉取
* - 记录每次列表请求耗时(elapsed),供分页处展示“请求用时”
* - 请求异常不在这里提示,交给响应拦截器统一处理
* @param options 见 UseListPageOptions
* @return 列表状态与分页事件处理函数
*/
export function useListPage<T, Q extends PageQuery>(options: UseListPageOptions<T, Q>) {
const { query, fetcher } = options
const loading = ref(false)
const total = ref(0)
const list = ref([]) as Ref<T[]>
/** 最近一次列表请求用时(毫秒),用于分页处展示统计耗时 */
const elapsed = ref<number | null>(null)
/** 按当前分页参数拉取列表 */
async function fetchList() {
loading.value = true
const startAt = performance.now()
try {
const res = await fetcher()
list.value = res.list || []
total.value = res.total || 0
} catch {
// 错误已由响应拦截器统一提示
} finally {
elapsed.value = Math.round(performance.now() - startAt)
loading.value = false
}
}
/** 条件查询:回到第一页后再拉取 */
function search() {
query.page = 1
return fetchList()
}
/** 切换页码 */
function handlePageChange(page: number) {
query.page = page
return fetchList()
}
/** 切换每页条数:默认回到第一页后再拉取 */
function handleSizeChange(pageSize: number) {
query.pageSize = pageSize
query.page = 1
return fetchList()
}
return {
loading,
list,
total,
elapsed,
fetchList,
search,
handlePageChange,
handleSizeChange,
}
}