Implementing.NET MAUI Radio Buttons
Guide for implementing Syncfusion.NET MAUI Radio Button (SfRadioButton) - a selection control that allows users to select one option from a set with checked and unchecked states.
When to Use This Skill
Use this skill when you need to:
- Implement radio buttons for mutually exclusive selections in.NET MAUI
- Create grouped radio button sets where only one option can be selected
- Handle radio button state changes and user interactions
- Customize radio button appearance (colors, sizing, text styling)
- Implement GroupKey-based or SfRadioGroup-based grouping
- Work with radio button events (StateChanged, StateChanging)
- Apply VisualStateManager to radio buttons
- Create forms with single-selection options (payment methods, preferences, etc.)
Component Overview
The Syncfusion.NET MAUI Radio Button (SfRadioButton) provides:
- Two States: Checked and unchecked with visual feedback
- Grouping: Multiple approaches (SfRadioGroup, GroupKey) for mutual exclusion
- Events: StateChanged and StateChanging for interaction handling
- Customization: Extensive styling options for colors, text, sizing
- Visual States: VisualStateManager integration for advanced styling
Documentation and Navigation Guide
Getting Started
📄 Read: references/getting-started.md
- Installing Syncfusion.Maui.Buttons NuGet package
- Registering the Syncfusion handler in MauiProgram.cs
- Creating your first SfRadioButton (XAML and C#)
- Setting caption text with the Text property
- Managing radio button state with IsChecked
- Basic SfRadioGroup usage for mutual exclusion
- Minimal working examples to get started quickly
Grouping and Organization
📄 Read: references/grouping.md
- GroupKey approach: Group radio buttons across different layouts
- CheckedItem property: Retrieve the currently selected radio button
- SfRadioGroup container: Automatic mutual exclusion management
- CheckedChanged event: Respond to selection changes in groups
- Orientation options: Vertical (default) or horizontal layouts
- SelectedValue property: Bind to selected radio button values
- Choosing between GroupKey and SfRadioGroup approaches
- Multiple independent groups in the same view
- Advanced grouping scenarios and patterns
Events and Interaction
📄 Read: references/events.md
- StateChanged event: Detect when radio button state changes
- StateChangedEventArgs: Access new state information
- StateChanging event: Intercept and cancel state changes
- Event handler implementation patterns (XAML and C#)
- Preventing unwanted state changes with event cancellation
- Event timing and lifecycle considerations
- Practical scenarios: validation, confirmation dialogs
- Responding to user interactions programmatically
Visual Customization
📄 Read: references/visual-customization.md
- CheckedColor and UncheckedColor: Customize state colors
- StrokeThickness: Adjust radio button border (platform considerations)
- Text appearance: TextColor, FontFamily, FontAttributes, FontSize
- HorizontalTextAlignment: Control text positioning
- LineBreakMode: Text wrapping and truncation options
- ControlSize: Adjust radio button dimensions
- ContentSpacing: Control spacing between button and text
- FontAutoScalingEnabled: Automatic font scaling for accessibility
- EnabledAnimation: Control state change animations
- Complete styling examples and best practices
Visual States
📄 Read: references/visual-states.md
- VisualStateManager integration with SfRadioButton
- Available visual states: Checked and Unchecked
- Defining visual states in XAML
- Creating visual states programmatically in C#
- Customizing appearance for each state
- Applying multiple property setters per state
- Complete working examples
- Best practices for visual state management