AG Grid社区版Text Filter的textMatcher配置后过滤不生效

• textMatcher并非企业版专属功能，社区版agTextColumnFilter在v28及以上版本原生支持该属性，文档未标注企业版标识是准确的，无需额外授权或引入其他模块即可使用。

失效原因排查 #

你当前配置无效果基本是以下几个原因导致，按优先级排查即可：

• 回调入参写法错误
  你代码中使用对象解构({ filter, value, filterText })接收参数是错误的，textMatcher回调接收的是三个独立的位置参数，并非包裹在对象中的属性，错误的解构会导致所有参数拿到undefined，匹配逻辑自然无法正常执行。正确的函数签名如下：

textMatcher: (filterOption, cellValue, inputFilterText) => {
  // 参数说明：
  // filterOption: 当前选中的过滤规则，例如你设置的默认值'contains'
  // cellValue: 当前行对应列的原始单元格值
  // inputFilterText: 用户在过滤输入框中输入的文本
  // 所有逻辑分支必须返回明确的布尔值，true代表该行匹配展示，false代表过滤隐藏
}

• 回调未返回明确布尔值
  如果你的自定义逻辑只处理了匹配成功返回true的分支，没有覆盖值为空、不匹配的分支，函数会默认返回undefined，AG Grid会将非true的返回值统一判定为不匹配，最终导致过滤结果异常。
  可参考下方最小可用示例调整：

const columnDefs = [
  {
    field: 'country',
    filter: 'agTextColumnFilter',
    filterParams: {
      defaultOption: 'contains',
      textMatcher: (filterOption, value, filterText) => {
        // 过滤输入为空时默认展示所有行
        if (!filterText?.trim()) return true;
        // 单元格值为空时直接判定不匹配
        if (value == null) return false;
        // 示例自定义逻辑：忽略大小写、忽略特殊符号后做包含匹配
        const normalize = (str) => String(str).toLowerCase().replace(/[^a-z0-9\u4e00-\u9fa5]/g, '');
        return normalize(value).includes(normalize(filterText));
      }
    }
  }
  // 其余列配置
]

• 版本兼容问题
  如果你使用的AG Grid社区版版本低于v28.0.0，textMatcher确实未在社区版实现，升级到v28及以上的稳定版本即可正常使用，不需要额外配置其他参数。

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