jqGrid获取总记录数方法详解

本文深入解析了如何在 jqGrid 中准确获取并复用数据总记录数，指出直接解析 `recordtext` 字符串（如提取 `{2}`）存在风险且不可靠，而应利用 `loadComplete` 回调中调用 `getGridParam('records')` 这一官方推荐方式——它能在数据加载完成后实时、精准地获取真实总数，并轻松同步更新外部 HTML 元素（如按钮、统计栏等），同时支持动态重载和扩展应用（如空数据禁用导出、联动请求参数），真正实现稳定、语义清晰、可维护的跨组件数据共享。

本文介绍如何从 jqGrid 的 recordtext 配置中动态提取实际记录总数（如 {2} 所代表的数值），并将其赋值给外部 HTML 元素（如按钮），实现跨组件的数据复用。

本文介绍如何从 jqGrid 的 `recordtext` 配置中动态提取实际记录总数（如 `{2}` 所代表的数值），并将其赋值给外部 HTML 元素（如按钮），实现跨组件的数据复用。

jqGrid 的 recordtext 选项（例如 "Record(s): {0} - {1} of {2}"）支持占位符 {2}，它会在分页渲染时自动替换为当前数据集的总行数。但该替换仅发生在内部 pager 渲染阶段，若需在 grid 外部（如独立按钮、标签或统计面板）复用该数值，不能直接读取字符串中的 {2}，而应通过 loadComplete 回调获取实时计算后的结果。

关键在于：{2} 并非静态文本，而是 jqGrid 在 loadComplete 阶段根据 records 参数动态注入的值。因此，推荐做法是在 loadComplete 中调用 getGridParam('records') 直接获取原始总记录数，而非解析 recordtext 字符串——这更可靠、语义清晰且避免正则匹配风险。

以下是完整实现方案：

$("#jqGrid").jqGrid({
    datatype: 'local',
    data: MaingridQueryResults_1,
    colModel: [
        { name: 'id', label: 'id', align: 'left', hidden: true, width: 30 },
        { name: 'phone', label: 'Société', align: 'left', width: 90 },
        { name: 'last_name', label: 'Nom', align: 'left', width: 80 },
        { name: 'first_name', label: 'Prénom', align: 'left', width: 60 }
    ],
    width: window.innerWidth - 50,
    height: 300,
    pager: "#jqGridPager",
    pginput: false,
    pgbuttons: false,
    pgtext: null,
    viewrecords: true,
    recordtext: "Record(s): {0} - {1} of {2}", // 占位符仅用于 pager 显示
    toppager: true,

    // ✅ 在数据加载完成后获取真实总记录数，并写入 HTML 按钮
    loadComplete: function () {
        const totalRecords = $(this).jqGrid('getGridParam', 'records');
        $('#htmlbutton').val(`${totalRecords} Results`);
        // 或：$('#htmlbutton').text(`${totalRecords} Results`);
        // 若按钮是 &lt;input type=&quot;button&quot;&gt;，用 .val()；若是 <button>，用 .text()
    }
});

⚠️ 注意事项：

• loadComplete 是最稳妥的时机：此时 records 参数已由 jqGrid 根据 data 或服务器响应准确计算完成；
• 避免依赖正则解析 recordtext（如原答案所示），因为 recordtext 是模板字符串，{2} 不代表当前值，仅是占位符标识；
• 若 grid 后续触发 trigger("reloadGrid")，loadComplete 会再次执行，确保外部元素值同步更新；
• 确保 #htmlbutton 在 DOM 中已存在，且 ID 唯一；建议将初始化逻辑置于 $(document).ready() 或确保脚本在 HTML 元素之后执行。

通过该方式，你不仅能精准复用总记录数，还能轻松扩展至其他场景——例如更新页面顶部统计栏、启用/禁用导出按钮（当 records === 0 时）、或作为 AJAX 请求的额外参数。核心原则始终是：信任 jqGrid 的 records 参数，而非字符串模板。

今天关于《jqGrid获取总记录数方法详解》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！