AG Grid Angular中setModel设置多值筛选不生效如何解决

问题原因 #

筛选逻辑未生效核心是两个常见问题：

1. onFirstDataRendered钩子触发时，Set筛选器的内置可选值列表尚未完成初始化，此时直接传入筛选值，不在可选列表内的值会被筛选组件直接丢弃，配置不会落地。
2. 未给对应列显式指定使用agSetColumnFilter筛选器，默认获取到的是文本筛选实例，无法识别type: 'set'的筛选模型。

修复方案 #

• 首先确认列定义显式声明使用Set筛选器

// 组件内列定义配置
columnDefs: ColDef[] = [
  // 其余业务列配置
  {
    field: 'country',
    filter: 'agSetColumnFilter', // 该项不可省略，否则默认使用文本筛选
  }
];

• 调整onFirstDataRendered内的逻辑，等待筛选模型配置完成后再触发筛选更新（兼容AG Grid 28及以上版本）

onFirstDataRendered(params) {
  const filterInstance = this.gridApi.getFilterInstance('country');
  // setModel方法返回Promise，代表筛选配置已完成加载落地
  filterInstance.setModel({
    type: 'set',
    values: ['Brazil', 'Russia']
  }).then(() => {
    this.gridApi.onFilterChanged();
  });
}

• 更稳定的无代码侵入方案：直接在列定义中配置初始筛选规则，不需要手动调用API获取筛选实例

columnDefs: ColDef[] = [
  {
    field: 'country',
    filter: 'agSetColumnFilter',
    // AG Grid 29+版本支持直接配置初始筛选模型，页面初始化后自动生效
    initialFilterModel: {
      type: 'set',
      values: ['Brazil', 'Russia']
    }
  }
];

注意：如果你的Set筛选器配置了异步加载可选值（即filterParams.values传入异步回调的场景），必须等待值列表加载完成后再设置筛选模型，否则传入的筛选值会因为不在可选列表中被自动忽略。

内容的提问来源于stack exchange，提问作者PRAFUL KUSUGAL