Vue / 系统课时
实现服务端分页
实现服务端分页
本课把分页组件接入用户列表接口,让页码和每页数量成为查询参数,并统一处理翻页、切换每页数量以及删除数据后的页码越界,保证页面始终落在有效数据页。
学习目标
- 正确传递页码与每页数量并接收总记录数
- 处理页码变化和每页数量变化的不同重载规则
- 在删除或数据收缩后自动修正无效页码
明确分页数据契约
服务端分页通常接收 page、pageSize 和查询条件,返回当前页 list 与满足条件的 total。前端不要用当前页数组长度推算总数,因为中间页通常是满页,无法反映真实记录量。
页码一般从 1 开始,但部分后端使用从 0 开始的偏移量。页面内部建议始终使用从 1 开始的页码,只在接口层做转换,避免分页组件、路由参数和业务代码混用两套规则。
下面是接口层片段示例,依赖项目已有的 @/utils/request。它明确分页参数和统一响应结构,使页面只处理稳定的 list 与 total。
import request from '@/utils/request'
export interface UserPageQuery {
keyword: string
status: '' | 'enabled' | 'disabled'
page: number
pageSize: number
}
export interface PageResult<T> {
list: T[]
total: number
}
export interface UserRow {
id: number
username: string
nickname: string
}
export function queryUsers(params: UserPageQuery) {
return request.get<PageResult<UserRow>>('/users', { params })
}
export function deleteUser(id: number) {
return request.delete(`/users/${id}`)
}接口接通后,可在网络面板中确认请求查询串包含 page 和 pageSize,响应体中的 total 是全部匹配记录数,而不是当前页条数。
接入分页组件
分页状态应与查询条件一起进入 loadUsers。切换页码时保留筛选条件;切换每页数量时回到第一页,因为新的分页尺寸可能让当前页失去原有含义。

下面是页面核心片段示例,依赖 Element Plus、queryUsers 和 deleteUser。接口响应需包含 list 与 total,查询接口需接受 page 和 pageSize。
<script setup lang="ts">
import { onMounted, reactive, ref } from 'vue'
import { ElMessage } from 'element-plus'
import {
deleteUser,
queryUsers,
type UserRow
} from '@/api/user'
const filters = reactive({
keyword: '',
status: '' as '' | 'enabled' | 'disabled'
})
const pagination = reactive({
page: 1,
pageSize: 10
})
const rows = ref<UserRow[]>([])
const total = ref(0)
const loading = ref(false)
async function loadUsers() {
loading.value = true
try {
const { data } = await queryUsers({
...filters,
page: pagination.page,
pageSize: pagination.pageSize
})
// 删除或筛选变化导致当前页越界时,修正后只补发一次请求。
const maxPage = Math.max(1, Math.ceil(data.total / pagination.pageSize))
if (data.list.length === 0 && data.total > 0 && pagination.page > maxPage) {
pagination.page = maxPage
await loadUsers()
return
}
rows.value = data.list
total.value = data.total
} finally {
loading.value = false
}
}
function handleSearch() {
pagination.page = 1
loadUsers()
}
function handleCurrentChange(page: number) {
pagination.page = page
loadUsers()
}
function handleSizeChange(pageSize: number) {
pagination.pageSize = pageSize
pagination.page = 1
loadUsers()
}
async function handleDelete(id: number) {
await deleteUser(id)
ElMessage.success('删除成功')
await loadUsers()
}
onMounted(loadUsers)
</script>
<template>
<el-table v-loading="loading" :data="rows" row-key="id">
<el-table-column prop="username" label="用户名" />
<el-table-column prop="nickname" label="昵称" />
<el-table-column label="操作" width="100">
<template #default="{ row }">
<el-button link type="danger" @click="handleDelete(row.id)">
删除
</el-button>
</template>
</el-table-column>
</el-table>
<el-pagination
v-model:current-page="pagination.page"
v-model:page-size="pagination.pageSize"
:total="total"
:page-sizes="[10, 20, 50]"
layout="total, sizes, prev, pager, next, jumper"
@current-change="handleCurrentChange"
@size-change="handleSizeChange"
/>
</template>预期结果
翻页:仅 page 改变,筛选条件和 pageSize 保持不变。
切换每页数量:pageSize 更新,并从第 1 页重新查询。
删除当前页最后一条:若当前页越界,自动跳到新的最大页并重新加载。
总数为 0:保留第 1 页,表格显示空状态,不重复请求。理解页码修正
假设每页 10 条,当前在第 3 页且总数为 21。删除第 21 条后,总数变为 20,最大页从 3 变为 2。若仍请求第 3 页,服务端会返回空数组;此时根据 total 计算最大页,将页码改为 2,再补发一次请求即可。
公式为 。只有“当前页为空、总数仍大于 0、当前页超过最大页”三个条件同时成立时才修正,避免真正的空结果触发重复请求。
避免重复请求与状态错乱
v-model:current-page 会先同步页码,再触发 current-change,处理函数中不需要再次做额外转换。切换每页数量时必须显式回到第一页。查询条件变化也应把页码重置为 1,否则用户可能在新的筛选结果中直接落到一个不存在的高页码。
递归调用 loadUsers 前先更新页码,并立即 return,可避免第一次请求的空数组覆盖第二次请求的有效结果。若项目存在并发请求,还应结合请求取消或序号校验,只接受最后一次分页请求。
验收服务端分页
准备超过两页的测试数据,验证下一页、上一页、跳页和切换每页数量。随后进入最后一页,逐条删除直到该页消失,页面应自动回到新的最后一页。最后使用无匹配条件查询,确认总数为 0 时不会循环请求。