AG Grid v34中agSetColumnFilter的Select all不再过滤空值问题咨询

设置 #

• 列过滤器：agSetColumnFilter
• 配置项：defaultToNothingSelected: true

观察到的行为 #

• 打开过滤器并点击**“Select all”**后，过滤器行为在两个版本中存在差异（客户端和服务端行模型均受影响）：
  • v33版本：该操作会过滤掉列值为空或NULL的行
  • v34版本：此类空值/NULL行被包含在内，过滤器未按预期过滤空值

预期行为（基于v33版本） #

点击“Select all”时，仍应排除列值为空或NULL的行。

示例代码 #

import { useState } from 'react';
import { AllCommunityModule, ModuleRegistry } from 'ag-grid-community';
import { AllEnterpriseModule } from 'ag-grid-enterprise';
import { AgGridReact } from 'ag-grid-react';

ModuleRegistry.registerModules([AllCommunityModule, AllEnterpriseModule]);

export const GridExample = () => {
  const [rowData, setRowData] = useState([
    { id: '1', category: 'A' },
    { id: '2', category: 'B' },
    { id: '3', category: 'C' },
    { id: '4', category: 'D' },
    { id: '5', category: null },
  ]);

  const [colDefs, setColDefs] = useState([
    { field: 'id', width: 100 },
    {
      field: 'category',
      flex: 1,
      filter: true,
      filterParams: {
        defaultToNothingSelected: true,
        values: ['A', 'B', 'C'],
      },
    },
  ]);

  return (
    <div style={{ width: '100%', height: '100%' }}>
      <AgGridReact
        rowData={rowData}
        columnDefs={colDefs}
        domLayout="autoHeight"
      />
    </div>
  );
};

咨询问题与解答 #

1. 这是v34版本的有意变更吗？ #

是有意变更。AG Grid 34版本针对agSetColumnFilter的空值处理逻辑做了调整，目的是让"全选"操作的语义更贴合字面意思——即选中所有潜在的选项（包括隐式的空值/NULL选项），统一过滤行为的一致性。

2. 若为有意变更，是否有配置或 workaround 恢复旧行为？ #

有两种可行方案：

• 自定义全选逻辑：通过filterParams中的selectAll回调函数手动实现v33版本的过滤逻辑，排除空值：

filterParams: {
  defaultToNothingSelected: true,
  values: ['A', 'B', 'C'],
  selectAll: (filter) => {
    // 筛选出所有非空选项并选中
    const validValues = filter.getValues().filter(val => val != null);
    filter.selectValues(validValues);
  }
}

• 隐藏空值选项并固化值列表：结合suppressEmptyFilterOptions配置隐藏空值选项，同时确保values列表中无空值，从根源上避免空值被选中：

filterParams: {
  defaultToNothingSelected: true,
  values: ['A', 'B', 'C'],
  suppressEmptyFilterOptions: true
}

如果使用服务端行模型，还需要在服务端的过滤逻辑中补充处理：当检测到过滤器处于"全选"状态时，主动排除列值为空/NULL的行。

3. 这是否应被视为Bug？ #

不算Bug。该变更是官方基于语义一致性的考量做出的正向调整，但如果你的业务逻辑依赖v33版本的旧行为，可以通过上述适配方案恢复原有效果。

内容的提问来源于stack exchange，提问作者Matej Dostal