syncfusion-aspnetcore-list-box

用途

本技能用于在 ASP.NET Core 应用中实现和配置 Syncfusion ListBox 组件，适合构建单选或多选的选择界面。典型用途包括下拉选择、筛选器、权限列表和批量操作。

主要能力

• 单选与多选：支持单选（类似单选按钮）和多选（类似复选框）模式，支持键盘与鼠标导航。
• 数据绑定：可从字符串数组、复杂对象数组及动态数据源绑定数据，支持 Text 与 Value 字段映射、AJAX 动态加载和实时更新。
• 高级功能：拖放（列表内排序及列表间转移）、双列表、模板、排序、分组、过滤、虚拟滚动、滚动条配置。
• 主题与外观：内置 Material、Bootstrap、Fluent、Tailwind 等主题，支持 Theme Studio 自定义主题、CSS 类定制、水平布局和响应式设计。
• 无障碍：支持 WCAG 合规与完整键盘导航。
• 事件：支持 change、select、doubleClick、scroll 等事件。

使用方式

1. 安装 NuGet 包：Install-Package Syncfusion.EJ2.AspNet.Core -Version 25.1.35
2. 在 _ViewImports.cshtml 中注册 TagHelper：@addTagHelper *, Syncfusion.EJ2
3. 在布局页引入主题样式与脚本：
   • 样式：https://cdn.syncfusion.com/ej2/25.1.35/fluent.css
   • 脚本：https://cdn.syncfusion.com/ej2/25.1.35/dist/ej2.min.js
   • 注册脚本管理器：<ejs-scripts></ejs-scripts>
4. 创建基本 ListBox：<ejs-listbox id="fruitBox" dataSource="@Model.Fruits"></ejs-listbox>

常用属性包括 dataSource、value、selectionSettings、fields、sortOrder、cssClass、allowDragAndDrop、height。常用方法包括 selectAll、clearSelection、selectItemsByRange、refresh、destroy。

适用场景

• 分类选择器（单选）
• 批量权限分配（多选、复选框）
• 产品筛选（多选、搜索）
• 功能优先级设置（多选、拖拽排序）
• 员工选择（多选、搜索、模板）
• 报表字段选择（多选、双列表）

限制

资料未提供该组件的收费、价格、平台兼容性细节或性能上限等具体信息，相关内容暂未提供。