Blazor 怎么实现一个可搜索的下拉列表

来源:这里教程网 时间:2026-02-21 17:33:03 作者:

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 条匹配结果),滚动到底部再加载更多(需配合虚拟滚动)

基本上就这些。自己手写灵活但要注意交互细节;用现成组件快且健壮,适合中大型项目。关键不是“能不能搜”,而是“搜得准不准、响应快不快、用着顺不顺”。

相关推荐