You need to enable JavaScript to run this app. 如何基于条件配置JQGrid多选列,实现部分行显隐复选框及全选适配
优惠活动
大模型
产品
解决方案
定价
更多

如何基于条件配置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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.09 21:45:03