Blazor 中实现可搜索的下拉列表,核心是用一个输入框(
input)配合过滤逻辑 + 下拉菜单(如
div或
select的自定义替代),而不是直接改造原生
select(它不支持搜索)。推荐用组件化方式:一个带搜索框的“虚拟下拉”,实时过滤选项并高亮匹配项。
用 InputText
+ foreach
渲染过滤后的选项
这是最轻量、可控性最强的方式,适合中小数据量(几百条以内):
定义一个字符串字段SearchTerm绑定到搜索输入框 准备原始选项列表(如
List<string> Options = new() { "苹果", "香蕉", "橙子", "菠萝" };</string>)
用 LINQ 过滤:@foreach (var item in Options.Where(x => x.Contains(SearchTerm, StringComparison.OrdinalIgnoreCase)))点击选项时,将值赋给绑定模型,并隐藏下拉面板(可用布尔变量
IsOpen控制显示)
支持键盘操作(方向键 + 回车)
提升体验的关键细节:
给搜索框加@onkeydown事件,监听
ArrowDown/
ArrowUp切换焦点项(维护一个
SelectedIndex)
Enter键选中当前高亮项;
Escape关闭下拉 用
tabindex="-1"和
focus()确保键盘能聚焦到选项元素上
用第三方组件(如 MudBlazor 或 Syncfusion)
如果项目已引入 UI 框架,直接复用成熟组件更省心:
MudBlazor:用<mudautocomplete></mudautocomplete>,支持搜索、异步加载、分组、自定义模板 Syncfusion:用
<sfdropdownlist tvalue="string" titem="string"></sfdropdownlist>并开启
AllowFiltering="true"注意:这些组件默认支持键盘导航和防抖搜索,但需按文档引入 JS 互操作或启用对应 NuGet 包
性能优化小技巧(大数据量时)
超过 1000 条数据时,别每次输入都全量遍历:
对选项做预处理:生成拼音首字母或分词索引(服务端更合适) 前端加防抖:用System.Threading.Timer或
Task.Delay延迟执行过滤(比如 300ms 后再更新
FilteredOptions) 限制显示数量(如只渲染前 20 条匹配结果),滚动到底部再加载更多(需配合虚拟滚动)
基本上就这些。自己手写灵活但要注意交互细节;用现成组件快且健壮,适合中大型项目。关键不是“能不能搜”,而是“搜得准不准、响应快不快、用着顺不顺”。
