- 各列表 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>
94 lines
2.6 KiB
TypeScript
94 lines
2.6 KiB
TypeScript
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,
|
||
}
|
||
}
|