Syncfusion ASP.NET Core Switch 技能用于在 ASP.NET Core 项目中实现 Syncfusion Switch(切换按钮)组件。Switch 是一种轻量、可访问的输入控件,用于在两种状态之间切换,基于 TypeScript/JavaScript 构建,可与 ASP.NET Core Razor 标记及 C# 后端代码集成。
用途:当用户需要为布尔输入(开/关、启用/禁用、是/否)创建切换按钮或开关、向表单添加 Switch 控件以进行用户状态选择、配置 Switch 外观(标签、尺寸、颜色)、通过事件处理程序处理状态变化,或将其与 ASP.NET Core 模型和后端逻辑集成时,可使用本技能。
主要能力:支持二元状态切换(checked/unchecked)、自定义 on/off 标签、键盘导航、事件驱动的变化检测、基于 CSS 的定制、WCAG 无障碍合规,并具有轻量和响应式特点。
使用方式:技能文档按主题分为多个参考文件:入门(TagHelper 注册与设置、NuGet 包安装与验证、创建首个 Switch 控件、设置 on/off 标签、基本初始化与渲染)、Switch 属性与配置(checked、disabled、name、value 等属性理解,与 ASP.NET Core 模型进行属性绑定,表单数据模型集成,将 Switch 状态绑定到 C# 属性,默认值与初始状态)、Switch 事件与状态管理(change 事件处理程序实现、检测状态转换、随表单提交 Switch 值、服务器端验证、跟踪用户交互)、样式与定制(wrapper、handle、inner 等 CSS 类,Material、Fabric、Bootstrap 主题应用,CSS 自定义外观,Theme Studio 集成,进阶样式技巧)、进阶操作模式(更改 Switch 尺寸:默认与 small、启用从右到左 RTL 支持、阻止或拦截状态变更、按条件设置禁用状态、通过表单提交 Switch 值)。
文档给出快速开始示例:在 _ViewImports.cshtml 中添加 @addTagHelper *, Syncfusion.EJ2,然后在页面中使用 <ejs-switch id="switchId"></ejs-switch>;带标签的 Switch 设置 onLabel="ON"、offLabel="OFF";带事件处理的 Switch 设置 change="onChange",并在脚本中通过 args.checked 读取状态。常见模式包括:绑定到表单模型(checked="@Model.NotificationEnabled")、基于条件禁用(disabled="@(!Model.IsPremiumUser)")、分组多个 Switch(如邮件通知与短信通知偏好)。
关键属性:checked(布尔,初始状态,true 为开、false 为关,用于设置页面加载时的默认位置)、disabled(布尔,是否禁用交互,用于显示但阻止更改,如权限或加载中)、name(字符串,HTML 表单 name 属性,用于表单提交与服务器端绑定)、value(字符串,HTML 表单值,发送到服务器的自定义值)、onLabel(字符串,开启状态显示的文本)、offLabel(字符串,关闭状态显示的文本)、change(函数,状态变化事件处理程序)、cssClass(字符串,自定义 CSS 类,用于应用主题或自定义外观)。
适用场景:用户偏好(启用/禁用通知、邮件、分析跟踪)、功能开关(切换实验性功能、测试版、维护模式)、表单选项(接受/同意条款、同意共享数据、同意表单)、管理控制(启用/禁用用户、功能或系统设置)、订阅状态(激活/停用订阅、试用版、许可证)。
限制:资料未提供该技能自身的收费、价格或授权信息,也未提供其运行环境与依赖版本等细节,暂未提供。完整参考可访问 Syncfusion ASP.NET Core Switch 文档。