SuperAPI AI 工具集

syncfusion-winui-autocomplete

前端与建站

查看项目

更新于 10-16 03:05

技能介绍

用途 SfAutoComplete 是 Syncfusion WinUI 的自动完成控件,用于在 WinUI 应用中实现边输入边筛选的建议列表和可搜索下拉框,支持单选与多选,多选时选中项以带文本、图片和关闭按钮的 Token 展示。

主要能力 支持单选与多选(SelectionMode);实时过滤,可选 StartsWith 或 Contains(TextSearchMode);自定义过滤逻辑(FilterBehavior);建议项分组(GroupMemberPath);匹配文本高亮(HighlightedTextColor);项模板、前置视图 LeadingView、后置视图 TrailingView 自定义;水印占位文本 PlaceholderText;无结果提示 NoResultsFoundContent;键盘导航。

用法要点 包为 Syncfusion.Editors.WinUI,命名空间 Syncfusion.UI.Xaml.Editors,控件为 SfAutoComplete。设置 ItemsSource 绑定数据,用 DisplayMemberPath 指定下拉项显示属性,TextMemberPath 指定选择框文本属性,多选使用 SelectionMode="Multiple",通过 SelectedItem 或 SelectedItems 获取选中项。

适用场景 邮件收件人选择器、商品搜索、分类标签、位置搜索、技能搜索等需要搜索建议的输入场景。

限制与提示 官方资料未提供收费、价格或授权信息,暂未提供。资料提示大数据量(超过约 1000 项)建议使用虚拟化,远程数据可考虑异步加载,超大列表使用 StartsWith 更高效;应为无结果、键盘导航和高对比度主题做处理。具体实现细节按其 references 目录下 getting-started、selection、searching-filtering、ui-customization、advanced-features 文档查阅。