You need to enable JavaScript to run this app. jqGrid场景下如何实现点击按钮跳转回记录原所在分页
优惠活动
大模型
产品
解决方案
定价
更多

jqGrid场景下如何实现点击按钮跳转回记录原所在分页

JqGrid 详情页返回原选中分页的跳转实现方案

核心逻辑

功能本质是完整留存jqGrid打开目标记录时的上下文参数,在详情页点击返回按钮时,直接将这些参数回传给列表页,让jqGrid直接定位到当初的分页位置,省去用户逐页翻找的操作成本。

分步实现流程

1. 列表页跳转详情时留存分页上下文

在jqGrid触发行选择、跳转详情的逻辑中,把当前分页的核心状态值持久化存储,避免页面跳转后上下文丢失。
对应实现代码:

// 绑定jqGrid行点击跳转详情的逻辑
$("#target-jqgrid").jqGrid('setGridParam', {
  onSelectRow: function (rowid) {
    // 提取jqGrid当前的关键状态参数
    const pageState = {
      currentPage: $(this).jqGrid('getGridParam', 'page'), // 当前所在分页
      rowNum: $(this).jqGrid('getGridParam', 'rowNum'), // 每页显示条数
      sortField: $(this).jqGrid('getGridParam', 'sortname'), // 当前排序字段
      sortType: $(this).jqGrid('getGridParam', 'sortorder'), // 当前排序方向
      searchCondition: $(this).jqGrid('getGridParam', 'postData').filters // 当前查询筛选条件
    }
    // 用sessionStorage存上下文,避免URL参数过长
    sessionStorage.setItem('jqGridReturnContext', JSON.stringify(pageState))
    // 跳转详情页
    window.location.href = `/record/detail?id=${rowid}`
  }
})

2. 详情页绑定返回按钮的重定向逻辑

详情页加载完成后,读取之前存储的jqGrid上下文,绑定返回按钮的点击事件,拼接跳转参数回到列表页。
对应实现代码:

// 详情页返回按钮绑定点击事件
$("#return-to-list-btn").on('click', function () {
  // 读取存储的jqGrid上下文
  const returnContext = JSON.parse(sessionStorage.getItem('jqGridReturnContext') || '{}')
  // 拼接回列表页的参数
  const redirectQuery = new URLSearchParams({
    page: returnContext.currentPage || 1,
    rowNum: returnContext.rowNum || 20,
    sortname: returnContext.sortField || 'id',
    sortorder: returnContext.sortType || 'asc',
    filters: returnContext.searchCondition || ''
  })
  // 执行跳转
  window.location.href = `/record/list?${redirectQuery.toString()}`
  // 跳转完成后清除临时存储的上下文,避免残留干扰
  sessionStorage.removeItem('jqGridReturnContext')
})

3. 列表页加载时还原jqGrid状态

列表页接收跳转携带的参数,在初始化jqGrid时直接传入对应状态值,让表格自动定位到目标分页位置,不需要默认从第一页开始加载。
对应实现代码:

// 从URL读取跳转携带的还原参数
const urlQuery = new URLSearchParams(window.location.search)
// 初始化jqGrid时直接传入读取到的状态值
$("#target-jqgrid").jqGrid({
  url: '/api/record-list',
  page: parseInt(urlQuery.get('page')) || 1,
  rowNum: parseInt(urlQuery.get('rowNum')) || 20,
  sortname: urlQuery.get('sortname') || 'id',
  sortorder: urlQuery.get('sortorder') || 'asc',
  postData: {
    filters: urlQuery.get('filters') || ''
  },
  // 其他原有列配置、交互配置保持不变
  colModel: [/* 原有列定义 */]
})

关键注意事项

  • 存储上下文优先使用sessionStorage,不要用localStorage,避免多标签页操作时上下文互相干扰
  • 回传参数完成后及时清除临时存储的上下文,防止用户在列表页手动修改筛选、排序条件后,后续返回操作被旧参数覆盖
  • 老版本jqGrid需要在还原分页前校验目标页码是否小于jqGrid的总页数,避免目标记录被删除后,页码超出最大范围导致表格展示空白页

额外优化点:如果jqGrid配置了固定的默认排序规则,可在参数为空时自动使用默认规则兜底,避免异常状态下表格加载失败。


内容的提问来源于stack exchange,提问作者Varshitha

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.16 02:06:04