Vue / 系统课时

实现服务端分页

实现服务端分页

本课把分页组件接入用户列表接口,让页码和每页数量成为查询参数,并统一处理翻页、切换每页数量以及删除数据后的页码越界,保证页面始终落在有效数据页。

学习目标

  • 正确传递页码与每页数量并接收总记录数
  • 处理页码变化和每页数量变化的不同重载规则
  • 在删除或数据收缩后自动修正无效页码

明确分页数据契约

服务端分页通常接收 page、pageSize 和查询条件,返回当前页 list 与满足条件的 total。前端不要用当前页数组长度推算总数,因为中间页通常是满页,无法反映真实记录量。

页码一般从 1 开始,但部分后端使用从 0 开始的偏移量。页面内部建议始终使用从 1 开始的页码,只在接口层做转换,避免分页组件、路由参数和业务代码混用两套规则。

下面是接口层片段示例,依赖项目已有的 @/utils/request。它明确分页参数和统一响应结构,使页面只处理稳定的 list 与 total。

ts
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。

vue
<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>

预期结果

text
翻页:仅 page 改变,筛选条件和 pageSize 保持不变。
切换每页数量:pageSize 更新,并从第 1 页重新查询。
删除当前页最后一条:若当前页越界,自动跳到新的最大页并重新加载。
总数为 0:保留第 1 页,表格显示空状态,不重复请求。

理解页码修正

假设每页 10 条,当前在第 3 页且总数为 21。删除第 21 条后,总数变为 20,最大页从 3 变为 2。若仍请求第 3 页,服务端会返回空数组;此时根据 total 计算最大页,将页码改为 2,再补发一次请求即可。

公式为 maxPage=max⁡(1,⌈total/pageSize⌉)\text{maxPage}=\max(1,\lceil \text{total}/\text{pageSize}\rceil)。只有“当前页为空、总数仍大于 0、当前页超过最大页”三个条件同时成立时才修正,避免真正的空结果触发重复请求。

避免重复请求与状态错乱

v-model:current-page 会先同步页码,再触发 current-change,处理函数中不需要再次做额外转换。切换每页数量时必须显式回到第一页。查询条件变化也应把页码重置为 1,否则用户可能在新的筛选结果中直接落到一个不存在的高页码。

递归调用 loadUsers 前先更新页码,并立即 return,可避免第一次请求的空数组覆盖第二次请求的有效结果。若项目存在并发请求,还应结合请求取消或序号校验,只接受最后一次分页请求。

验收服务端分页

准备超过两页的测试数据,验证下一页、上一页、跳页和切换每页数量。随后进入最后一页,逐条删除直到该页消失,页面应自动回到新的最后一页。最后使用无匹配条件查询,确认总数为 0 时不会循环请求。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

实现服务端分页

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通