$npx -y skills add syncfusion/maui-ui-components-skills --skill syncfusion-maui-checkboxImplements Syncfusion .NET MAUI CheckBox (SfCheckBox) controls in MAUI applications. Use when implementing checkboxes, selection controls, or toggle buttons in .NET MAUI. Covers three-state checkboxes, indeterminate state, checkbox customization, checkbox events, visual states, a
| 1 | # Implementing Checkboxes in .NET MAUI |
| 2 | |
| 3 | The Syncfusion .NET MAUI CheckBox (SfCheckBox) is a selection control that allows users to choose one or more options from a set. It supports three states (checked, unchecked, indeterminate), extensive visual customization, and event-driven state management. |
| 4 | |
| 5 | ## When to Use This Skill |
| 6 | |
| 7 | Use this skill when the user needs to: |
| 8 | |
| 9 | - **Implement checkbox controls** in .NET MAUI applications |
| 10 | - **Add selection controls** for single or multiple choice scenarios |
| 11 | - **Create three-state checkboxes** with indeterminate state support |
| 12 | - **Customize checkbox appearance** (colors, shapes, sizes, text) |
| 13 | - **Handle checkbox events** (StateChanged, StateChanging) |
| 14 | - **Apply visual states** using VisualStateManager |
| 15 | - **Build checkbox groups** for multi-select scenarios (e.g., settings, forms, filters) |
| 16 | - **Implement parent-child checkbox hierarchies** with select-all functionality |
| 17 | - **Create terms and conditions** acceptance UI |
| 18 | - **Add accessible selection controls** with MAUI styling |
| 19 | |
| 20 | ## Component Overview |
| 21 | |
| 22 | The SfCheckBox control provides: |
| 23 | - **Three-state support**: Checked, Unchecked, and Indeterminate states |
| 24 | - **Visual customization**: Colors, corner radius, stroke thickness, tick color |
| 25 | - **Text customization**: Font, color, alignment, line break modes |
| 26 | - **Event handling**: StateChanged and StateChanging events |
| 27 | - **Visual State Manager**: Custom appearance for each state |
| 28 | - **Animation control**: Enable/disable state change animations |
| 29 | |
| 30 | ## Documentation and Navigation Guide |
| 31 | |
| 32 | ### Getting Started and Installation |
| 33 | |
| 34 | 📄 **Read:** [references/getting-started.md](references/getting-started.md) |
| 35 | |
| 36 | **When to read**: User is setting up SfCheckBox for the first time, needs installation steps, or wants basic implementation examples. |
| 37 | |
| 38 | Topics covered: |
| 39 | - Installing Syncfusion.Maui.Buttons NuGet package |
| 40 | - Registering Syncfusion handler (ConfigureSyncfusionCore) |
| 41 | - Basic CheckBox implementation (XAML and C#) |
| 42 | - Setting checkbox caption text |
| 43 | - Understanding three states (Checked, Unchecked, Indeterminate) |
| 44 | - Single checkbox scenarios (terms of service, agreements) |
| 45 | - Multiple checkbox groups (multi-select options) |
| 46 | - Intermediate state with parent-child relationships |
| 47 | - Select-all checkbox patterns |
| 48 | |
| 49 | ### Visual Customization |
| 50 | |
| 51 | 📄 **Read:** [references/visual-customization.md](references/visual-customization.md) |
| 52 | |
| 53 | **When to read**: User wants to customize the appearance of checkboxes, change colors, adjust sizes, modify text styling, or control animations. |
| 54 | |
| 55 | Topics covered: |
| 56 | - Shape customization (CornerRadius for rounded checkboxes) |
| 57 | - State colors (CheckedColor, UncheckedColor) |
| 58 | - Stroke thickness customization |
| 59 | - Caption text appearance (TextColor, FontFamily, FontSize, FontAttributes, HorizontalTextAlignment) |
| 60 | - Tick color customization |
| 61 | - LineBreakMode options (wrap or truncate text) |
| 62 | - Size customization (ControlSize property) |
| 63 | - Font auto-scaling (FontAutoScalingEnabled) |
| 64 | - Animation control (EnabledAnimation) |
| 65 | - Content spacing between checkbox and text |
| 66 | |
| 67 | ### Events and State Management |
| 68 | |
| 69 | 📄 **Read:** [references/events.md](references/events.md) |
| 70 | |
| 71 | **When to read**: User needs to respond to checkbox state changes, validate selections, or implement custom logic when checkboxes are toggled. |
| 72 | |
| 73 | Topics covered: |
| 74 | - StateChanged event and StateChangedEventArgs |
| 75 | - StateChanging event (cancellable before state change) |
| 76 | - Event handling patterns in XAML and C# |
| 77 | - Programmatic state changes |
| 78 | - Event-driven UI updates |
| 79 | - Preventing state changes with Cancel property |
| 80 | - Coordinating multiple checkbox states |
| 81 | |
| 82 | ### Visual States with VisualStateManager |
| 83 | |
| 84 | 📄 **Read:** [references/visual-states.md](references/visual-states.md) |
| 85 | |
| 86 | **When to read**: User wants to apply different visual appearances for checked, unchecked, or indeterminate states using VisualStateManager. |
| 87 | |
| 88 | Topics covered: |
| 89 | - Visual State Manager overview for SfCheckBox |
| 90 | - Three visual states (Checked, Unchecked, Intermediate) |
| 91 | - XAML implementation with VisualStateGroups |
| 92 | - C# implementation with VisualState setters |
| 93 | - Customizing properties per state |
| 94 | - Complete examples for each state |