Vue3 + Element Plus 实现前端手动分页

实现思路

在 Vue3 中结合 Element Plus 实现分页功能，需处理以下核心逻辑：

数据存储 ：完整数据集存储在 allData 中
分页控制 ：使用 currentPage 和 pageSize 计算当前页数据
表格渲染：仅展示当前页的切片数据
分页组件：监听页码/页数变化更新数据

完整代码实现

vue 复制代码

<template>
  <div>
    <!-- 表格组件 -->
    <el-table :data="currentPageData" style="width: 100%">
      <el-table-column prop="id" label="ID" width="180" />
      <el-table-column prop="name" label="名称" width="180" />
      <!-- 添加更多列 -->
    </el-table>

    <!-- 分页组件 -->
    <el-pagination
      background
      layout="total, sizes, prev, pager, next, jumper"
      :total="allData.length"
      :page-sizes="[10, 20, 50, 100]"
      :page-size="pageSize"
      :current-page="currentPage"
      @size-change="handleSizeChange"
      @current-change="handleCurrentChange"
    />
  </div>
</template>

<script setup>
import { ref, computed, onMounted } from 'vue'

// 原始数据（模拟接口返回）
const allData = ref([])
// 当前页码
const currentPage = ref(1)
// 每页显示条数
const pageSize = ref(10)

// 计算当前页数据
const currentPageData = computed(() => {
  const start = (currentPage.value - 1) * pageSize.value
  const end = start + pageSize.value
  return allData.value.slice(start, end)
})

// 处理页数变化
const handleSizeChange = (newSize) => {
  pageSize.value = newSize
  currentPage.value = 1 // 重置到第一页
}

// 处理页码变化
const handleCurrentChange = (newPage) => {
  currentPage.value = newPage
}

// 模拟获取数据
onMounted(async () => {
  // 实际替换为你的API请求
  const mockData = []
  for (let i = 1; i <= 1000; i++) {
    mockData.push({ id: i, name: `项目${i}` })
  }
  allData.value = mockData
})
</script>

关键点说明

数据切片计算

使用计算属性动态计算当前页数据：

javascript 复制代码

const start = (currentPage.value - 1) * pageSize.value
const end = start + pageSize.value
return allData.value.slice(start, end)

分页事件处理
- @size-change：页容量变化时触发
- @current-change：页码变化时触发
性能优化
- 只对当前页数据进行渲染（避免全量DOM操作）
- 使用 computed 自动缓存计算结果
- 分页参数变化时自动更新视图

实际应用建议

大数据量优化

当数据量超过 10,000 条时：

javascript 复制代码

// 在分页组件添加防抖
import { debounce } from 'lodash-es'
const handleCurrentChange = debounce((newPage) => {
  currentPage.value = newPage
}, 300)

后端分页模式

若需后端分页（推荐用于超大数据集）：

javascript 复制代码

const fetchData = async () => {
  const res = await api.get('/data', {
    params: {
      page: currentPage.value,
      size: pageSize.value
    }
  })
  currentPageData.value = res.data.items
  // 设置总条目数（从后端获取）
  total.value = res.data.totalCount
}

分页组件属性

html 复制代码

<el-pagination
  :total="total"        // 总条目数
  :page-size="pageSize" // 每页显示条目数
  :current-page="currentPage" // 当前页
  :page-sizes="[10, 20, 50]" // 可选的每页条数
  layout="total, sizes, prev, pager, next" // 布局组件
/>

此方案可在 10 万条数据量级保持流畅运行，通过前端分页减少网络传输压力，同时保持用户体验的连贯性。