分页状态重置需“不换引用、只清状态”:用.value赋值重置currentPage、pageSize等ref,避免重建ref导致响应式断连;搜索时强制currentPage.value = 1并传page: 1请求;跳转页码需Math.min/max边界保护;配合useOffsetPagination时,只需更新total和currentPage.value,其余由Hook自动同步。

分页查询的状态重置与同步,核心在于“不换引用、只清状态”——尤其当使用 ref 管理当前页码(currentPage)、每页条数(pageSize)、总数据量(total)等关键字段时,必须避免直接替换 ref 本身,否则会断开响应式连接,导致 UI 不更新或翻页逻辑失效。
分页 ref 状态的正确重置方式
假设你用 ref 定义了分页基础状态:
const currentPage = ref(1) const pageSize = ref(10) const total = ref(0) const data = ref([]) const isFetching = ref(false)
当执行“搜索重置”或“切换筛选条件”时,应重置为初始值,而非新建 ref:
- ✅ 正确:直接赋值新值,保留原 ref 引用
currentPage.value = 1<br>pageSize.value = 10<br>total.value = 0<br>data.value = []
- ❌ 错误:重新创建 ref(会丢失响应式绑定)
currentPage = ref(1) // 报错(const)或断连(let)
搜索触发时自动重置页码并拉取数据
用户提交搜索表单后,需强制回到第 1 页,同时保持 pageSize 不变(除非用户主动改过):
立即学习“前端免费学习笔记(深入)”;
const search = (params) => {
currentPage.value = 1 // 重置页码
isFetching.value = true
fetchList({ ...params, page: 1, size: pageSize.value })
.then(res => {
data.value = res.list || []
total.value = res.total || 0
})
.finally(() => {
isFetching.value = false
})
}
注意:不要在回调里再写 currentPage.value = res.page —— 后端返回的 page 往往不可信,页码应由前端完全控制。
页码变更与总页数联动时的边界保护
手动输入页码或点击跳转时,需防止越界(如输入 999 但总共只有 5 页)。可借助 Math.min 和 Math.max 钳制:
const goToPage = (pageNum) => {
const maxPage = Math.max(1, Math.ceil(total.value / pageSize.value))
currentPage.value = Math.min(Math.max(1, pageNum), maxPage)
}
这样既保证页码合法,又无需额外 watch 或 computed,逻辑清晰、无副作用。
与 useOffsetPagination 等组合式分页 Hook 协同工作
若已接入 @vueuse/core 的 useOffsetPagination,它内部已封装好钳制与同步逻辑。此时你只需:
- 把接口返回的
total赋给它的total参数(支持 ref 或 getter) - 调用其
prev()/next()或手动设currentPage.value,它会自动校验边界 - 搜索重置时,调用
search({})并确保传入page: 1,Hook 内部会同步更新所有状态
不需要再单独管理 isFirstPage 或 isLastPage,这些都由 Hook 响应式推导,天然与 currentPage 和 total 保持一致。


















