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

实现思路

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

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

完整代码实现

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

关键点说明

1. 数据切片计算

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

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

2. 分页事件处理

   • @size-change：页容量变化时触发
   • @current-change：页码变化时触发

3. 性能优化

   • 只对当前页数据进行渲染（避免全量DOM操作）
   • 使用 computed 自动缓存计算结果
   • 分页参数变化时自动更新视图

实际应用建议

1. 大数据量优化

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

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

2. 后端分页模式

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

   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
   }

3. 分页组件属性

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

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