Implementing .NET MAUI Expander (SfExpander)
The Syncfusion .NET MAUI Expander control provides collapsible and expandable content sections for creating space-efficient layouts. Users can tap headers to reveal or hide content with smooth animations, making it ideal for accordion layouts, FAQs, and organized data displays.
When to Use This Skill
Use this skill when you need to:
- Implement collapsible sections for space-efficient layouts and organized content display
- Create accordion-style interfaces for FAQs, settings panels, or grouped data
- Build invoice or receipt views with expandable sections (date, items, payment, address)
- Design dynamic header/content layouts where users tap to reveal more information
- Add animated expand/collapse functionality with customizable duration and easing
- Handle expand/collapse events for controlling user interactions and state management
- Customize header appearance with backgrounds, icon positions, and Visual State Manager styling
Component Overview
- Interactive expand/collapse with single tap on header
- Fully customizable header and content view layouts
- Smooth animations with configurable duration and easing
- Event system for Expanding, Expanded, Collapsing, and Collapsed states
- Programmatic control via
IsExpanded property
- Visual State Manager support for dynamic styling
- Header appearance customization (background, icon position, colors)
- Event cancellation for Expanding and Collapsing actions
- Platform-optimized rendering and animations
Documentation and Navigation Guide
Getting Started
📄 Read: references/getting-started.md
When to read: First-time setup, installation, basic implementation
- Installing Syncfusion.Maui.Toolkit NuGet package
- Registering Syncfusion handler (ConfigureSyncfusionToolkit)
- Creating basic SfExpander instance
- Defining Header and Content views
- Using IsExpanded property to control initial state
- Complete invoice example with multiple expanders
- Running your first expander application
Header and Content Customization
📄 Read: references/header-content-customization.md
When to read: Customizing header and content sections with layouts and views
- Loading any UI view in Header and Content properties
- Using Grid layouts with icons and labels
- Icon integration with font families
- Multi-expander layouts (invoice with multiple sections)
- Best practices for content structure
- Avoiding common pitfalls (Label wrapping in containers)
Animation and Events
📄 Read: references/animation-events.md
When to read: Controlling animation behavior and handling expand/collapse events
- AnimationDuration property (default: 300ms)
- AnimationEasing property (Linear, SinOut, etc.)
- Programmatic control with IsExpanded property
- Expanding event: Triggered before expansion (cancellable)
- Expanded event: Triggered after expansion completes
- Collapsing event: Triggered before collapse (cancellable)
- Collapsed event: Triggered after collapse completes
- Event handler examples with cancellation logic
Appearance and Styling
📄 Read: references/appearance-styling.md
When to read: Customizing header appearance, colors, icons, and Visual State Manager styling
- HeaderIconPosition property (Start, End)
- HeaderBackground color customization
- HeaderIconColor customization
- Visual State Manager (VSM) states: Expanded, Collapsed, PointerOver, Normal
- Dynamic appearance changes based on expander state
- Complete VSM examples with color transitions
1---2name: syncfusion-maui-toolkit-expander3description: Implements the Syncfusion .NET MAUI Expander (SfExpander) control for collapsible and expandable content sections. Use when working with expanders, collapsible sections, accordions, expandable panels, or expand/collapse functionality in .NET MAUI applications. Covers space-efficient layouts, header customization and expand/collapse animations.4---5
6# Implementing .NET MAUI Expander (SfExpander)
7
8The Syncfusion .NET MAUI Expander control provides collapsible and expandable content sections for creating space-efficient layouts. Users can tap headers to reveal or hide content with smooth animations, making it ideal for accordion layouts, FAQs, and organized data displays.
9
10## When to Use This Skill
11
12Use this skill when you need to:
13
14- **Implement collapsible sections** for space-efficient layouts and organized content display
15- **Create accordion-style interfaces** for FAQs, settings panels, or grouped data
16- **Build invoice or receipt views** with expandable sections (date, items, payment, address)
17- **Design dynamic header/content layouts** where users tap to reveal more information
18- **Add animated expand/collapse functionality** with customizable duration and easing
19- **Handle expand/collapse events** for controlling user interactions and state management
20- **Customize header appearance** with backgrounds, icon positions, and Visual State Manager styling
21
22## Component Overview
23
24- Interactive expand/collapse with single tap on header
25- Fully customizable header and content view layouts
26- Smooth animations with configurable duration and easing
27- Event system for Expanding, Expanded, Collapsing, and Collapsed states
28- Programmatic control via `IsExpanded` property
29- Visual State Manager support for dynamic styling
30- Header appearance customization (background, icon position, colors)
31- Event cancellation for Expanding and Collapsing actions
32- Platform-optimized rendering and animations
33
34## Documentation and Navigation Guide
35
36### Getting Started
37📄 **Read:** [references/getting-started.md](references/getting-started.md)
38
39When to read: First-time setup, installation, basic implementation
40- Installing Syncfusion.Maui.Toolkit NuGet package
41- Registering Syncfusion handler (ConfigureSyncfusionToolkit)
42- Creating basic SfExpander instance
43- Defining Header and Content views
44- Using IsExpanded property to control initial state
45- Complete invoice example with multiple expanders
46- Running your first expander application
47
48### Header and Content Customization
49📄 **Read:** [references/header-content-customization.md](references/header-content-customization.md)
50
51When to read: Customizing header and content sections with layouts and views
52- Loading any UI view in Header and Content properties
53- Using Grid layouts with icons and labels
54- Icon integration with font families
55- Multi-expander layouts (invoice with multiple sections)
56- Best practices for content structure
57- Avoiding common pitfalls (Label wrapping in containers)
58
59### Animation and Events
60📄 **Read:** [references/animation-events.md](references/animation-events.md)
61
62When to read: Controlling animation behavior and handling expand/collapse events
63- AnimationDuration property (default: 300ms)
64- AnimationEasing property (Linear, SinOut, etc.)
65- Programmatic control with IsExpanded property
66- Expanding event: Triggered before expansion (cancellable)
67- Expanded event: Triggered after expansion completes
68- Collapsing event: Triggered before collapse (cancellable)
69- Collapsed event: Triggered after collapse completes
70- Event handler examples with cancellation logic
71
72### Appearance and Styling
73📄 **Read:** [references/appearance-styling.md](references/appearance-styling.md)
74
75When to read: Customizing header appearance, colors, icons, and Visual State Manager styling
76- HeaderIconPosition property (Start, End)
77- HeaderBackground color customization
78- HeaderIconColor customization
79- Visual State Manager (VSM) states: Expanded, Collapsed, PointerOver, Normal
80- Dynamic appearance changes based on expander state
81- Complete VSM examples with color transitions
82
gabrielmoreira