syncfusion-maui-radio-button

实现 .NET MAUI 单选按钮

Syncfusion .NET MAUI 单选按钮（SfRadioButton）的实现指南——一种选择控件，允许用户从一组选项中选择一个，并具有选中和未选中状态。

何时使用此技能

在以下情况下使用此技能：

• 在 .NET MAUI 中实现用于互斥选择的单选按钮
• 创建单选按钮组，确保一次只能选择一个选项
• 处理单选按钮状态更改和用户交互
• 自定义单选按钮外观（颜色、尺寸、文本样式）
• 实现基于 GroupKey 或 SfRadioGroup 的分组
• 使用单选按钮事件（StateChanged、StateChanging）
• 将 VisualStateManager 应用于单选按钮
• 创建包含单选选项的表单（例如支付方式、偏好设置等）

组件概览

Syncfusion .NET MAUI 单选按钮（SfRadioButton）提供：

• 两种状态： 选中和未选中，并提供视觉反馈
• 分组： 支持多种互斥方式（SfRadioGroup、GroupKey）
• 事件： 提供 StateChanged 和 StateChanging 事件来处理交互
• 自定义： 提供丰富的样式选项，可设置颜色、文本和尺寸
• 视觉状态： 支持集成 VisualStateManager 以实现高级样式设置

文档和导航指南

入门

📄 阅读： references/getting-started.md

• 安装 Syncfusion.Maui.Buttons NuGet 包
• 在 MauiProgram.cs 中注册 Syncfusion 处理程序
• 创建第一个 SfRadioButton（XAML 和 C#）
• 使用 Text 属性设置说明文本
• 使用 IsChecked 管理单选按钮状态
• 使用 SfRadioGroup 实现基本的互斥选择
• 帮助快速上手的最小可运行示例

分组和组织

📄 阅读： references/grouping.md

• GroupKey 方式：跨不同布局分组单选按钮
• CheckedItem 属性：获取当前选中的单选按钮
• SfRadioGroup 容器：自动管理互斥选择
• CheckedChanged 事件：响应组内的选择更改
• Orientation 选项：垂直（默认）或水平布局
• SelectedValue 属性：绑定到选中的单选按钮值
• 选择使用 GroupKey 还是 SfRadioGroup
• 在同一视图中创建多个独立组
• 高级分组场景和模式

事件和交互

📄 阅读： references/events.md

• StateChanged 事件：检测单选按钮状态何时更改
• StateChangedEventArgs：访问新状态信息
• StateChanging 事件：拦截并取消状态更改
• 事件处理程序实现模式（XAML 和 C#）
• 使用事件取消阻止不需要的状态更改
• 事件时序和生命周期注意事项
• 实用场景：验证、确认对话框
• 以编程方式响应用户交互

视觉自定义

📄 阅读： references/visual-customization.md

• CheckedColor 和 UncheckedColor：自定义状态颜色
• StrokeThickness：调整单选按钮边框（需考虑平台差异）
• 文本外观：TextColor、FontFamily、FontAttributes、FontSize
• HorizontalTextAlignment：控制文本位置
• LineBreakMode：文本换行和截断选项
• ControlSize：调整单选按钮尺寸
• ContentSpacing：控制按钮与文本之间的间距
• FontAutoScalingEnabled：启用自动字体缩放以提升无障碍体验
• EnabledAnimation：控制状态更改动画
• 完整的样式示例和最佳实践

视觉状态

📄 阅读： references/visual-states.md

• 将 VisualStateManager 集成到 SfRadioButton
• 可用的视觉状态：Checked 和 Unchecked
• 在 XAML 中定义视觉状态
• 在 C# 中以编程方式创建视觉状态
• 为每种状态自定义外观
• 为每种状态应用多个属性设置器
• 完整的可运行示例
• 视觉状态管理的最佳实践