如何基于条件配置JQGrid多选列,实现部分行显隐复选框及全选适配
JQGrid 条件控制行复选框显示与全选逻辑实现方案
实现逻辑说明
基于JQGrid的渲染回调与事件劫持机制,分两层落地需求:在表格逐行渲染完成后,根据预设校验规则调整对应行复选框的显示/可用状态;重写表头全选的触发逻辑,让全选操作仅作用于通过校验的行。
第一步:行级条件驱动的复选框控制
利用JQGrid的loadComplete回调(表格完成所有行渲染后触发),逐行执行校验并调整对应复选框状态,核心配置代码如下:
$("#yourGridId").jqGrid({ // 保留原有表格配置 multiselect: true, loadComplete: function() { const gridDom = $(this); // 抽取公共校验方法,保证全场景判断逻辑一致 const checkRowSelectable = (rowData) => { // 替换为实际校验规则,示例匹配场景:行ID在指定数组内即可选 const allowIdList = [44, 40, 32, 26]; return allowIdList.includes(Number(rowData.id)); } // 遍历所有渲染完成的行 gridDom.jqGrid('getRowData').forEach(rowData => { const rowId = rowData.id; const $rowTr = $(`#${rowId}`); const $rowCheckbox = $rowTr.find('input.cbox'); const isSelectable = checkRowSelectable(rowData); if (!isSelectable) { // 不符合校验:隐藏复选框、禁用交互、清除遗留选中状态、加标记类 $rowCheckbox.hide().prop({ disabled: true, checked: false }); $rowTr.addClass('jqgrid-disabled-row'); } else { // 符合校验:恢复复选框显示与可用状态 $rowCheckbox.show().prop('disabled', false); $rowTr.removeClass('jqgrid-disabled-row'); } }); } });
第二步:适配表头全选的交互逻辑
JQGrid内置的全选逻辑默认会选中所有可见行,需要解绑原全选事件、替换为仅操作可选行的自定义逻辑,代码可直接放在loadComplete回调末尾执行,避免元素未渲染导致的绑定失败:
// 定位表头全选复选框 const $selectAllCheckbox = $("#jqgh_yourGridId_cb"); // 移除JQGrid原有的全选点击事件 $selectAllCheckbox.off('click'); // 绑定自定义全选逻辑 $selectAllCheckbox.on('click', function() { const isSelectAllChecked = $(this).prop('checked'); // 筛选所有没有标记为禁用的可选行ID const selectableRowIds = []; $("#yourGridId").find('tr[id]:not(.jqgrid-disabled-row)').each(function() { selectableRowIds.push($(this).attr('id')); }); if (isSelectAllChecked) { // 全选状态:仅批量选中通过校验的行 $("#yourGridId").jqGrid('setSelection', selectableRowIds, true); } else { // 取消全选状态:清空所有选中记录 $("#yourGridId").jqGrid('resetSelection'); } });
实操注意事项
- 校验逻辑必须抽成公共方法,避免行渲染时的判断、全选时的判断出现规则不一致,导致复选框显示但全选时无法选中的偏差
- 翻页、筛选、表格重绘操作都会触发
loadComplete回调,每次重绘都会重新执行状态控制逻辑,不需要额外在其他事件里重复调用 - 隐藏复选框时必须同步设置
disabled: true属性,避免用户通过键盘Tab键聚焦到不可见的复选框、误触发选中操作 - 自定义全选逻辑绑定完成后,要注意和JQGrid内置的
onSelectAll事件做兼容,若原配置里已绑定onSelectAll事件,需在回调中手动排除禁用行的选中状态,避免逻辑冲突
内容的提问来源于stack exchange,提问作者ThangLe
相关产品推荐
相关产品推荐

