AG Grid中SSRM模式下expandOrCollapseAll事件未触发的技术分析

问题背景

在AG Grid的数据分组功能中，开发者可以通过调用gridApi.expandAll()和gridApi.collapseAll()方法来展开或折叠所有分组行。根据官方文档描述，这两个API方法调用时应该触发expandOrCollapseAll事件。然而在实际使用中发现，当使用服务器端行模型(SSRM)时，这个事件并没有被正确触发。

现象对比

在客户端行模型(CSRM)中，调用expandAll()会展开所有层级的组行，同时正确触发expandOrCollapseAll事件。而在SSRM模式下，虽然expandAll()方法确实会展开当前层级的组行（SSRM与CSRM在展开行为上有所不同），但相应的事件却没有被触发。

技术原因分析

通过查看AG Grid的源代码可以发现，expandOrCollapseAll事件是在客户端扩展服务(clientSideExpansionService.ts)中被分发的。然而在服务器端行模型(serverSideRowModel.ts)的expandAll方法实现中，并没有包含相应的事件分发逻辑。

这种不一致性导致了SSRM模式下虽然功能上实现了展开/折叠操作，但缺少了对应的事件通知机制，使得依赖此事件进行后续处理的代码无法正常工作。

解决方案建议

从技术实现角度来看，解决方案相对直接：应该在SSRM的expandAll和collapseAll方法中添加与CSRM相同的事件分发逻辑。具体来说，就是在执行展开/折叠操作后，通过事件服务分发expandOrCollapseAll事件。

这种修改不会影响现有的功能行为，只是补充了事件通知机制，使SSRM和CSRM在API行为上保持一致性。

对开发者的影响

对于依赖expandOrCollapseAll事件进行业务逻辑处理的开发者来说，当前SSRM下的行为会导致：

1. 无法监听全局展开/折叠操作
2. 需要寻找替代方案来检测展开状态变化
3. 在混合使用CSRM和SSRM时可能出现不一致的行为

临时解决方案

在官方修复发布前，开发者可以考虑以下临时解决方案：

1. 重写expandAll和collapseAll方法，在调用原始方法后手动触发事件
2. 使用其他相关事件（如rowGroupOpened）来模拟全局状态变化
3. 在SSRM模式下避免依赖expandOrCollapseAll事件

总结

AG Grid作为功能丰富的数据表格库，在不同行模型下保持API行为一致性非常重要。expandOrCollapseAll事件在SSRM下的缺失虽然不影响核心功能，但破坏了开发者对API行为的预期。建议开发团队在后续版本中统一两种行模型下的事件触发机制，以提供更一致的开发体验。