NatTable 的 FilterRow 默认会在过滤单元格获得焦点后显示“清除过滤”图标，即使用户未输入任何内容；本文详解其成因及通过自定义 FilterRowDataProvider 和 IFilterStrategy 实现精准控制图标的显示逻辑。
natable 的 filterrow 默认会在过滤单元格获得焦点后显示“清除过滤”图标，即使用户未输入任何内容；本文详解其成因及通过自定义 `filterrowdataprovider` 和 `ifilterstrategy` 实现精准控制图标的显示逻辑。
在 NatTable 中，“清除过滤”（×）图标是否显示，并非由 UI 焦点状态决定，而是严格依据底层 FilterRowDataProvider 所提供的过滤值是否为非空。也就是说：只要 FilterRowDataProvider.getFilterValue(columnIndex) 返回非 null 且非空字符串（对字符串类型）或非默认值（对数值/对象类型），图标就会被渲染——哪怕该值是用户仅点击后未输入就离开产生的意外残留。
你观察到的现象（图标出现在无实际过滤条件的列中），根本原因在于：你的 FilterRowDataProvider 实现可能在初始化或交互过程中，将某些列的过滤值设为了空字符串 ""、" " 或其他非 null 值，而 NatTable 的默认 TextFilterStrategy 会将其视为有效过滤条件，从而触发图标显示。
✅ 正确解决方案：精准控制过滤值有效性
1. 自定义 FilterRowDataProvider，确保空值返回 null
重写 getFilterValue(int columnIndex) 方法，对字符串类型做严格判空：
public class StrictFilterRowDataProvider extends DefaultFilterRowDataProvider<mydatatype> {
public StrictFilterRowDataProvider(IObservableList<mydatatype> bodyModel) {
super(bodyModel);
}
@Override
public Object getFilterValue(int columnIndex) {
Object value = super.getFilterValue(columnIndex);
// 对字符串类型：仅当非 null 且 trim 后非空才保留
if (value instanceof String && ((String) value).trim().isEmpty()) {
return null; // 关键：返回 null → 图标不显示
}
return value;
}
}</mydatatype></mydatatype>
2. 配置时使用该 Provider（而非默认）
// 创建数据层时传入自定义 provider
FilterRowDataLayer filterRowDataLayer = new FilterRowDataLayer(bodyDataLayer,
new StrictFilterRowDataProvider(yourObservableList));
3. （可选）增强过滤策略一致性
若需进一步统一行为，可自定义 IFilterStrategy，在 filter(...) 前校验值有效性：
public class StrictTextFilterStrategy implements IFilterStrategy<mydatatype> {
@Override
public boolean filter(MyDataType rowObject, int columnIndex, Object filterValue) {
if (filterValue == null ||
(filterValue instanceof String && ((String) filterValue).trim().isEmpty())) {
return true; // 不过滤：相当于无条件通过
}
// 执行实际匹配逻辑...
return doActualMatch(rowObject, columnIndex, filterValue);
}
}</mydatatype>
然后注册到配置注册表：
configRegistry.registerConfigAttribute(
FilterRowConfigAttributes.FILTER_STRATEGY,
new StrictTextFilterStrategy(),
DisplayMode.NORMAL,
FilterRowDataLayer.FILTER_ROW_COLUMN_LABEL_PREFIX + columnIndex);
⚠️ 注意事项
- 勿依赖 DisplayConverter 清理值：FILTER_DISPLAY_CONVERTER 仅影响显示格式，不影响底层过滤值判断；
- 避免在 configureRegistry 中重复注册同一列配置：你当前代码中对 PROP_KEY_SYMBOL_SIZE 和 PROP_KEY_SYMBOL_ADDRESS 列多次注册 TEXT_MATCHING_MODE，虽不报错但易引发覆盖或冗余；
- 调试建议：在 getFilterValue() 中添加日志或断点，确认各列返回值真实状态，这是定位问题的最快路径。
通过以上改造，即可彻底消除“无输入却显示清除图标”的异常行为，使 FilterRow 的 UI 表现与业务语义严格一致：有真实过滤条件 → 显示图标；否则完全隐藏。
