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 { list: T[] total: number page?: number pageSize?: number } /** useListPage 的入参 */ export interface UseListPageOptions { /** 列表页自己的查询条件(含 page / pageSize),组合式函数会直接修改其中的分页字段 */ query: Q /** 拉取数据的方法:内部读取 query 上的 page / pageSize 传给后端 */ fetcher: () => Promise> } /** * 列表分页封装 * - 统一维护 loading / list / total,列表页不再各写一套 * - 统一分页交互语义:条件查询回到第一页;切换页码按页拉取;切换每页条数回到第一页再拉取 * - 记录每次列表请求耗时(elapsed),供分页处展示“请求用时” * - 请求异常不在这里提示,交给响应拦截器统一处理 * @param options 见 UseListPageOptions * @return 列表状态与分页事件处理函数 */ export function useListPage(options: UseListPageOptions) { const { query, fetcher } = options const loading = ref(false) const total = ref(0) const list = ref([]) as Ref /** 最近一次列表请求用时(毫秒),用于分页处展示统计耗时 */ const elapsed = ref(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, } }