BootstrapBlazor MultiFilter组件搜索功能优化：支持自定义字符串比较方式

在BootstrapBlazor组件库中，MultiFilter组件是一个功能强大的多选过滤器控件，它内置了搜索功能，可以帮助用户快速筛选选项。然而，在9.6.2版本之前，该组件的搜索功能使用的是默认的字符串包含比较方式(StringComparison.Ordinal)，这种比较方式区分大小写，在某些场景下可能不够灵活。

原始实现分析

MultiFilter组件的搜索功能核心逻辑位于OnSearchValueChanged方法中。原始实现如下：

private Task OnSearchValueChanged(string? val)
{
    _searchText = val;
    if (_source != null)
    {
        if (!string.IsNullOrEmpty(_searchText))
        {
            _items = _source.Where(i => i.Text.Contains(_searchText)).ToList();
        }
        else
        {
            _items = null;
        }
        StateHasChanged();
    }
    return Task.CompletedTask;
}

这段代码直接使用了string.Contains方法，没有指定字符串比较方式，因此默认采用区分大小写的Ordinal比较。这在需要不区分大小写搜索的场景下会带来不便。

优化方案实现

为了解决这个问题，BootstrapBlazor在9.6.2-beta02版本中为MultiFilter组件新增了一个StringComparison参数，允许开发者自定义字符串比较方式。主要改动包括：

1. 新增StringComparison参数，默认值为StringComparison.OrdinalIgnoreCase（不区分大小写）

[Parameter]
public StringComparison StringComparison { get; set; } = StringComparison.OrdinalIgnoreCase;

2. 修改OnSearchValueChanged方法，使用指定的StringComparison进行比较

private Task OnSearchValueChanged(string? val)
{
    _searchText = val;
    if (_source != null)
    {
        if (!string.IsNullOrEmpty(_searchText))
        {
            _items = [.. _source.Where(i => i.Text.Contains(_searchText, StringComparison))];
        }
        else
        {
            _items = null;
        }
        StateHasChanged();
    }
    return Task.CompletedTask;
}

使用方式

开发者现在可以通过设置StringComparison参数来灵活控制搜索行为：

<MultiFilter ShowSearch="true" StringComparison="@StringComparison.Ordinal" />

或者保持默认的不区分大小写方式：

<MultiFilter ShowSearch="true" />

技术背景

StringComparison枚举提供了多种字符串比较方式：

• CurrentCulture：使用当前区域性的排序规则
• CurrentCultureIgnoreCase：使用当前区域性的排序规则，忽略大小写
• InvariantCulture：使用固定区域性的排序规则
• InvariantCultureIgnoreCase：使用固定区域性的排序规则，忽略大小写
• Ordinal：使用序号排序规则（二进制比较）
• OrdinalIgnoreCase：使用序号排序规则，忽略大小写

在大多数国际化应用中，推荐使用CurrentCulture或CurrentCultureIgnoreCase，以获得与用户区域设置一致的排序行为。而在需要精确匹配或性能敏感的场景下，可以使用Ordinal或OrdinalIgnoreCase。

总结

BootstrapBlazor对MultiFilter组件的这一优化，使得开发者能够更灵活地控制搜索行为，满足不同场景下的需求。通过简单的参数配置，即可实现区分大小写或不区分大小写的搜索功能，大大提升了组件的适用性和用户体验。

这一改进也体现了BootstrapBlazor团队对开发者反馈的积极响应和对组件细节的持续优化，使得这个优秀的Blazor组件库更加完善和实用。