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
相关产品推荐
相关产品推荐

