You need to enable JavaScript to run this app. jqGrid嵌入模态框后无法显示?模态场景下使用有哪些条件限制?
优惠活动
大模型
产品
解决方案
定价
更多

jqGrid嵌入模态框后无法显示?模态场景下使用有哪些条件限制?

核心问题根因

这个现象是Bootstrap模态框和jqGrid搭配时的经典坑,本质是初始化时机不匹配:

  • 你现在在页面刚加载完成的阶段就直接执行jqGrid初始化,此时带modal fade类的模态框默认是display: none状态
  • jqGrid初始化时会自动读取父容器的真实渲染宽高来计算自身尺寸,当父容器处于隐藏状态时,读取到的宽高值为0。这就会导致虽然DOM节点全部正常生成,但是jqGrid的外层包裹容器宽高全部被计算为0,视觉上完全不可见
  • 你把jqGrid放到模态框外部测试时,对应容器是页面默认可见状态,初始化时能拿到正常的宽高值,所以渲染完全正常,和配置本身没有关系
可直接落地的修复方案
  • 优先调整初始化时机:不要在页面加载阶段直接初始化jqGrid,改为等待模态框完全弹出、DOM完成渲染后再执行初始化
    直接用Bootstrap提供的模态框渲染完成监听事件shown.bs.modal即可,替换原有初始化逻辑:
    // 移除原页面加载阶段直接执行的jqGrid初始化代码
    // 绑定模态框完全显示后的触发事件
    $('#addLkp05Modal').on('shown.bs.modal', function () {
        // 在此处放置原有的jqGrid初始化配置
        $("#apprEtcListToggle").jqGrid({
            width: '100%',
            height: 'auto',
            datatype: "local",
            styleUI : 'Bootstrap',
            iconSet : 'Octicons',
            shrinkToFit : false,
            autowidth: true,
            multiselect: true,
            // 删除原配置里无效的 modal: true 参数,这是jqGrid自身弹窗的配置,和Bootstrap模态框无关,容易引发样式冲突
            colNames: ["기호", "용도", "구조", "면적", "단가", "감정평가액"],
            colModel : [
                { name: "BD_Sign", index: "BD_Sign", align: 'center', width: 60 },
                { name: "BD_Use", index: "BD_Use", align: 'center' },
                { name: "BD_Structure", index: "BD_Structure", align: 'center' },
                { name: "EstiArea", index: "EstiArea", align: 'center' },
                { name: "AppliedUPrice", index: "AppliedUPrice", align: 'center' },
                { name: "BDApprasalVal", index: "BDApprasalVal", align: 'center' },
            ],
            beforeSelectRow: () => {
                // 注意确认选择器对应的表格是否存在,不存在的配置会触发JS报错阻断渲染
                if ($("#apprListToggle").length) {
                    $("#apprListToggle").jqGrid("resetSelection");
                }
            }
        });
        // 初始化完成后再绑定本地数据源并触发重载
        $("#apprEtcListToggle").jqGrid('setGridParam', { data : apprEtcItems }).trigger('reloadGrid');
    
        // 宽度适配校正:主动读取模态框body的实际可用宽度,校正表格宽度避免错位
        const availableWidth = $('#addLkp05Modal .modal-body').width();
        $("#apprEtcListToggle").jqGrid('setGridWidth', availableWidth);
    })
    
不推荐的兜底方案(仅作特殊场景参考)

如果业务要求必须在页面加载阶段就完成jqGrid初始化,不能等模态框弹出再初始化,可以把模态框的隐藏方式从display: none改成离屏隐藏,让jqGrid初始化时能读到正常的容器宽高:

/* 覆盖Bootstrap默认的模态框隐藏逻辑 */
.modal.fade {
  display: block !important;
  position: absolute;
  left: -10000px;
  visibility: hidden;
}
.modal.fade.in {
  left: auto;
  visibility: visible;
}

这个方案会增加页面初始渲染的资源开销,正常场景优先用前面调整初始化时机的方案即可。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.20 03:54:06