用途
Syncfusion Angular Dropdowns 是一套面向 Angular 应用的下拉类 UI 组件实现指南，属于 Syncfusion Angular UI 组件技能集合。资料说明其覆盖 AutoComplete、ComboBox、DropDownList、ListBox、Mention、MultiSelect 等组件，用于在 Angular 项目中实现输入建议、下拉选择、多选、提及等交互。
安全与信任边界
资料将安全要求放在首要位置，明确默认姿态为“仅本地数据”：
- 所有下拉组件默认使用本地、内存中的数据源。
- 通过 DataManager 或任意 Observable/HTTP 源绑定远程 HTTP 端点属于非默认、高风险操作，在生产代码中启用前必须经过明确的安全评审。
- 除非应用已通过安全评审，确认目标端点由与应用相同的团队拥有和运营、端点实施认证/授权/输入校验、所有响应在绑定到 dataSource 前经过净化、且已部署覆盖该源的 CSP，否则不应生成或建议远程 DataManager/HTTP 数据源配置。
资料列出的强制性安全要求包括：默认使用本地数据（除非远程源获明确批准，否则 dataSource 使用普通 TypeScript 数组）；不使用公共或第三方 URL；绑定前净化所有外部数据（来自 API 响应、本地存储读取的值在赋给 dataSource 或 value 前须去除 HTML/脚本内容）；净化用户过滤输入（在将输入文本转发到任何服务器查询前去除非字母数字字符以防注入）；默认不使用 crossDomain: true；固定包版本（每个 @syncfusion/ej2-* 依赖在 package.json 中锁定到精确版本，安装后对照 lockfile 校验）；无 SRI 不得从 CDN 加载资源（CSS/JS 应在构建时从 node_modules 解析）；本地存储中不得存放敏感数据（enablePersistence 不得存储令牌、凭据或 PII，读回的值使用前须净化）。
AutoComplete
AutoComplete 是文本输入组件，在用户输入时提供匹配建议。资料描述其设计用途包括：输入即提示（type-ahead）、自由格式输入（用户可输入任意值，不受列表限制）、搜索/过滤（多种过滤策略：StartsWith、Contains、EndsWith）、自动填充（自动补全第一个匹配建议）、分组建议（按 groupBy 字段分类）、虚拟滚动（高效处理数千项）、模板定制（item、group、header、footer、空状态模板）。
关键特征：单选，用户也可输入自由格式值；数据源支持本地数组、远程 DataManager、OData、Web API、Observable（async pipe）；内置过滤 StartsWith、EndsWith、Contains；自动填充可内联补全首个匹配；虚拟滚动支持 1,000+ 项；支持模板驱动（ngModel）与响应式（FormControl）表单；符合 WCAG 2.2，支持完整键盘导航与 ARIA 属性；支持 item、group、header、footer、noRecords、actionFailure 模板与 CSS 主题。
文档导航涵盖：入门（安装 @syncfusion/ej2-angular-dropdowns 包、Angular 21+ 独立组件项目、导入 AutoCompleteModule 与 CSS 主题、基本数据绑定、弹窗高度/宽度/占位符、[(value)] 双向绑定）；数据绑定（本地数组、字段映射 value/text/iconCss、DataManager 远程数据、RxJS Observable 的 async pipe、allowObjectBinding 对象绑定、value 预选）；过滤与搜索（filterType、suggestionCount、minLength、ignoreCase、ignoreAccent、debounceDelay、通过 filtering 事件与 updateData 自定义过滤）；分组与模板；功能配置（autofill、highlight、禁用单项或整个组件、allowResize、enableVirtualization、showPopupButton、showClearButton、enableRtl、sortOrder）；表单支持与校验；无障碍与本地化（WCAG 2.2、Section 508、ADA、键盘快捷键、ARIA 属性、L10n.load() 本地化、RTL）；高级模式（自动填充、高亮、多字段 Predicate 自定义过滤、iconCss 图标、聚焦时从浏览器本地存储显示建议列表、自定义搜索与高亮样式）；API 参考。
资料给出快速开始示例（Angular 21 独立组件）：
// app.component.ts (Angular 21 Standalone)
import { Component } from '@angular/core';
import { AutoCompleteModule } from '@syncfusion/ej2-angular-dropdowns';
@Component({
selector: 'app-root',
standalone: true,
imports: [AutoCompleteModule],
template: `
<ejs-autocomplete
id="sports"
[dataSource]="sportsData"
placeholder="Find a sport"
[(value)]="selectedValue">
</ejs-autocomplete>
`
})
export class AppComponent {
public sportsData: string[] = [
'Badminton', 'Basketball', 'Cricket',
'Football', 'Golf', 'Hockey', 'Tennis'
];
public selectedValue: string = '';
}
安装命令（资料要求固定版本）：
ng add @syncfusion/ej2-angular-dropdowns@<version>
CSS 引入（styles.css，构建时从 node_modules 解析）：
@import '../node_modules/@syncfusion/ej2-base/styles/material3.css';
@import '../node_modules/@syncfusion/ej2-inputs/styles/material3.css';
@import '../node_modules/@syncfusion/ej2-dropdowns/styles/material3.css';
@import '../node_modules/@syncfusion/ej2-lists/styles/material3.css';
@import '../node_modules/@syncfusion/ej2-popups/styles/material3.css';
常见模式包括：复杂对象数据过滤（fields 映射 value 字段）；Autofill + Highlight（autofill、highlight、filterType="StartsWith"）；带防抖的远程数据（资料标注为受限模式，需安全评审，未默认提供远程 DataManager 示例）；大数据集虚拟滚动（注入 VirtualScroll，enableVirtualization，popupHeight）。
关键属性速查包括 dataSource、fields、placeholder、value、filterType（默认 'Contains'）、minLength（默认 1）、suggestionCount（默认 20）、autofill、highlight、ignoreCase、ignoreAccent、debounceDelay（默认 300）、enableVirtualization、allowResize、showClearButton、showPopupButton、enabled、readonly、allowObjectBinding、sortOrder、popupHeight（默认 '300px'）、popupWidth（默认 '100%'）、locale（默认 'en-US'）、enableRtl。
资料还提供工作流决策树，按数据源、过滤方式、是否需要自动填充/高亮、数据规模、表单类型、无障碍与本地化需求引导选择配置。
ComboBox
ComboBox 是灵活的下拉组件，允许用户从预定义列表中选择，或在启用 allowCustom 时输入自定义值。支持输入时搜索/过滤、按类别分组、通过模板定制 item/group/header/footer 显示。
关键特征：从预定义列表或自定义值中单选；数据源支持本地数组、远程 DataManager、OData、Web API、异步数据；内置可配置过滤策略；虚拟滚动支持 10,000+ 项；支持模板驱动与响应式表单；符合 WCAG 2.2，支持键盘导航与 ARIA；支持 item、group、header 模板与 CSS 主题。
文档导航涵盖：入门（安装包、Angular 21+ 独立组件、导入模块与 CSS 主题、最小代码创建 ComboBox、基本事件处理与配置）；数据绑定与来源（本地数组、复杂数据的 text/value 字段映射、Web API/OData 远程数据、DataManager 适配器、RxJS Observable 的 async pipe、动态数据更新）；过滤与搜索（allowFiltering、过滤类型、大小写敏感、变音符号过滤、防抖、最小过滤字符、远程查询自定义过滤）；分组与模板（groupBy、item 模板、组头模板、footer 模板、模板组合与性能优化）；高级功能配置（禁用单项或整个组件、只读模式、虚拟滚动、动态调整大小、允许列表外自定义值、样式与主题、RTL）；表单支持与校验（双向绑定等，资料在此处截断）。
适用场景
资料表明该技能适用于需要在 Angular 应用中实现输入建议、下拉单选、多选、提及、列表选择等交互的开发者，尤其是使用 Syncfusion Angular UI 组件库、Angular 21+ 独立组件、并关注无障碍与本地化的项目。
限制与未提供信息
资料未提供收费、价格、平台支持范围、性能基准或效果承诺等信息。DropDownList、ListBox、Mention、MultiSelect 组件仅在概述中提及，未展开详细说明。ComboBox 的表单支持与校验部分在资料中未完整给出。远程数据绑定被明确列为需安全评审的受限模式，资料未默认提供远程 DataManager 示例。