
本文介绍如何从 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`);
// 若按钮是 <input type="button">,用 .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 参数,而非字符串模板。

















