JeecgBoot项目中隐藏列在beforeEditSubmit事件中的参数缺失问题解析

问题背景

在使用JeecgBoot框架的BasicTable组件进行表格编辑时，开发人员发现当表格列设置为隐藏状态(ifShow:false)时，在beforeEditSubmit等编辑相关事件中，事件参数record对象会缺失这些隐藏列的信息。这给与后端接口的数据交互带来了不便，因为后端接口通常需要完整的实体数据，包括那些前端不需要展示的字段。

问题现象

具体表现为：

1. 当某列(如ID列)设置为ifShow:false隐藏时
2. 在触发beforeEditSubmit、edit-cancel、edit-end、edit-change等编辑相关事件时
3. 事件参数中的record对象不包含这些隐藏列的数据

技术分析

隐藏列的两种实现方式

JeecgBoot的BasicTable组件提供了两种隐藏列的方式：

1. ifShow:false
   这种方式会完全从DOM中移除该列，不仅不显示，而且在事件参数中也会被过滤掉

2. defaultHidden:true
   这种方式会将列保留在DOM中，只是通过CSS隐藏显示，数据仍然会保留在事件参数中

数据流分析

当使用ifShow:false时，组件内部可能在以下环节过滤了数据：

1. 列配置解析阶段：直接将隐藏列从columns配置中移除
2. 数据绑定阶段：只绑定可见列的数据到视图层
3. 事件触发阶段：只收集可见列的数据到事件参数

解决方案

针对这个问题，JeecgBoot官方建议使用defaultHidden属性替代ifShow属性来隐藏列。这样可以在保持列隐藏的同时，确保数据完整性。

代码示例

{
  title: 'ID',
  dataIndex: 'id',
  defaultHidden: true,  // 替代ifShow:false
  // 其他配置...
}

两种隐藏方式的对比

特性	ifShow:false	defaultHidden:true
DOM中是否存在	否	是
事件参数中是否包含数据	否	是
性能影响	较小	略大
适用场景	完全不需要的列	需要数据但隐藏的列

最佳实践建议

1. 关键字段保留：对于ID等后端交互必需但前端不需要展示的字段，使用defaultHidden:true
2. 完全移除不必要列：对于确实不需要在任何场景下使用的列，可以使用ifShow:false减少DOM负担
3. 事件处理兼容：在事件处理函数中，做好数据可能不完整的兼容处理

总结

JeecgBoot框架的表格组件提供了灵活的列显示控制功能。理解ifShow和defaultHidden的区别，可以帮助开发者在不同场景下做出合适的选择，既保证前端展示效果，又不影响后端数据交互。对于需要在事件中获取完整数据的场景，defaultHidden:true是更合适的选择。