用途:在 Angular 项目中实现输入即提示的自动完成组件,用户键入时从数据源显示匹配建议,同时允许输入任意自由文本值。
主要能力:支持本地数组、远程 DataManager(OData、Web API)、Observable 数据源;内置 StartsWith、Contains、EndsWith 过滤;自动填充首个匹配、高亮匹配字符、按 groupBy 字段分组;提供 item、group、header、footer、noRecords、actionFailure 模板;千级以上数据可用虚拟滚动;支持模板驱动(ngModel)与响应式(FormControl)表单;具备键盘导航、ARIA 属性与本地化支持。
使用方式:安装 ng add @syncfusion/ej2-angular-dropdowns,导入 AutoCompleteModule 及所需 CSS 主题,在模板中使用 <ejs-autocomplete>,通过 dataSource、fields、filterType、value 等属性配置。官方快速示例基于 Angular 21 standalone 组件,并用 [(value)] 双向绑定。
适用场景:搜索框、表单输入建议、远程 API 驱动的联想输入、大数据量列表选择等。
限制:虚拟滚动需注入 VirtualScroll;远程过滤可用 debounceDelay 降低请求频率;具体价格、许可与平台兼容版本暂未提供。