AG-Grid Angular 如何禁用 loadingCellRenderer?
AG-Grid Angular 禁用加载渲染提示的原生配置方案
两类加载场景的对应配置
很多开发者会混淆两种加载提示的触发逻辑,对应配置完全独立,可按需选择:
1. 整表加载遮罩提示
如果是表格加载时覆盖在整个网格区域的“Loading”提示,AG-Grid 提供了原生开关直接关闭,无需修改样式:
在gridOptions中添加配置:
const gridOptions: GridOptions = { // 原有业务配置保留 suppressLoadingOverlay: true }
配置后整表加载遮罩会被完全禁用,不会出现任何遮罩占位。
2. 单元格级加载占位提示
如果是行数据异步加载时,单元格位置单独出现的“稍候(one moment)”类占位文本,也就是loadingCellRenderer的渲染效果,AG-Grid 没有单独的suppressLoadingCell类全局开关,可通过官方支持的自定义渲染逻辑实现完全禁用,无需依赖CSS隐藏:
- 全局生效配置:在
gridOptions中将loadingCellRenderer替换为返回空DOM节点的实现,直接覆盖默认的文本渲染逻辑:
配置后所有列的加载占位都会渲染为空白,不会出现任何提示文本。loadingCellRenderer: () => ({ getGui: () => document.createElement('span') }) - 单列精细化配置:如果不需要全局生效,可在对应列的
colDef中单独覆盖loadingCellRenderer配置,仅对指定列禁用加载提示。
避坑提示
- 单元格级的加载渲染仅在行节点被标记为加载状态时触发:如果使用客户端行模型,常规初始化场景不会触发该渲染逻辑,此时出现的加载提示基本都是全局遮罩层,优先检查
suppressLoadingOverlay配置即可。 - 不建议通过CSS设置
display: none隐藏提示元素,会导致行加载完成后占位元素无法正常销毁,引发单元格交互异常。
内容的提问来源于stack exchange,提问作者RooksStrife
相关产品推荐
相关产品推荐

