syncfusion-maui-switch

实现 Syncfusion .NET MAUI Switch（SfSwitch）

Syncfusion .NET MAUI Switch（SfSwitch）控件提供了一种高效的状态切换方式，支持丰富的自定义选项、多种状态以及高级视觉样式。

何时使用此技能

在以下场景中使用此技能：

• 在 .NET MAUI 应用中实现切换开关或开/关控件
• 创建带有视觉反馈的二元状态控件
• 为进行中场景实现不确定状态
• 自定义开关外观（颜色、大小、圆角半径、边框）
• 在开关滑块内添加自定义图标或路径
• 通过验证或取消逻辑处理状态更改事件
• 使用 Visual State Manager 应用高级样式
• 支持国际化所需的从右到左（RTL）布局
• 实现液态玻璃效果等现代 UI 效果
• 提供具有视觉状态反馈的无障碍切换控件

组件概述

SfSwitch 控件提供：

• 多种状态： 开启、关闭、不确定状态及其禁用变体
• 丰富的自定义选项： 颜色、大小、边框、圆角半径和自定义图标
• 事件处理： 支持取消操作的 StateChanged 和 StateChanging 事件
• Visual State Manager： 针对悬停、按下和禁用状态的高级状态样式
• 现代功能： 带来高端 UI 体验的液态玻璃效果
• RTL 支持： 支持面向全球应用的双向布局
• 主题： Material、Cupertino 和 Fluent 设计主题

文档和导航指南

入门

📄 阅读： references/getting-started.md

在以下场景中使用：

• 安装 Syncfusion.Maui.Buttons NuGet 包
• 使用 ConfigureSyncfusionCore 注册处理程序
• 创建首个基础开关实现
• 在 XAML 和 C# 中设置开关
• 根据状态更改执行操作

开关状态

📄 阅读： references/switch-states.md

在以下场景中使用：

• 了解所有可用的开关状态
• 实现开启、关闭和默认状态
• 启用并使用不确定状态（IsOn = null）
• 创建禁用状态变体（禁用的开启/关闭/不确定状态）
• 以编程方式控制状态转换
• 设置初始状态值

事件

📄 阅读： references/events.md

在以下场景中使用：

• 处理状态更改通知（StateChanged 事件）
• 验证或取消状态转换（StateChanging 事件）
• 在事件处理程序中访问旧状态值和新状态值
• 实现条件状态更改
• 在开关状态更改时触发操作
• 阻止不需要的状态转换

自定义

📄 阅读： references/customization.md

在以下场景中使用：

• 自定义轨道和滑块颜色
• 调整开关尺寸（宽度、高度）
• 配置边框颜色和粗细
• 设置圆角半径以实现圆润外观
• 为滑块添加自定义图标或路径
• 为不同状态应用不同颜色
• 创建品牌化或主题化的开关设计

Visual State Manager

📄 阅读： references/visual-state-manager.md

在以下场景中使用：

• 应用高级状态样式
• 自定义悬停状态外观（OnHovered、OffHovered、IndeterminateHovered）
• 设置按下状态的样式（OnPressed、OffPressed、IndeterminatePressed）
• 配置禁用状态的视觉效果（OnDisabled、OffDisabled、IndeterminateDisabled）
• 实现复杂的视觉过渡
• 创建交互式悬停和按压效果

高级功能

📄 阅读： references/advanced-features.md

在以下情况下使用：

• 为现代 UI 启用液态玻璃效果（EnableLiquidGlassEffect）
• 实现从右到左（RTL）布局支持
• 支持用于国际化的双向布局
• 在鲜艳的背景上应用玻璃拟态效果
• 处理特定于平台的功能（.NET 10+、iOS 26、macOS 26）