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
- Apply modern liquid glass effects for premium translucent designs in high-end applications
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)
- Modern liquid glass effects (.NET 10+, macOS 26+, iOS 26+)
- 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.Expander NuGet package
- Registering Syncfusion handler (ConfigureSyncfusionCore)
- 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
Liquid Glass Effect
📄 Read: references/liquid-glass-effect.md
When to read: Applying modern translucent designs with adaptive color tinting
- When to use liquid glass effect (premium UX applications)
- Wrapping SfExpander inside SfGlassEffectView
- Setting EnableLiquidGlassEffect="True" on expander
- Using Background="Transparent" for glass effect
- Complete invoice example with liquid glass
- Platform requirements: .NET 10+, macOS 26+, iOS 26+
- Multiple expanders with consistent glass effect
1---2name: syncfusion-maui-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, expand/collapse animations, and liquid glass effects.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- **Apply modern liquid glass effects** for premium translucent designs in high-end applications
22
23## Component Overview
24
25- Interactive expand/collapse with single tap on header
26- Fully customizable header and content view layouts
27- Smooth animations with configurable duration and easing
28- Event system for Expanding, Expanded, Collapsing, and Collapsed states
29- Programmatic control via `IsExpanded` property
30- Visual State Manager support for dynamic styling
31- Header appearance customization (background, icon position, colors)
32- Modern liquid glass effects (.NET 10+, macOS 26+, iOS 26+)
33- Event cancellation for Expanding and Collapsing actions
34- Platform-optimized rendering and animations
35
36## Documentation and Navigation Guide
37
38### Getting Started
39📄 **Read:** [references/getting-started.md](references/getting-started.md)
40
41When to read: First-time setup, installation, basic implementation
42- Installing Syncfusion.Maui.Expander NuGet package
43- Registering Syncfusion handler (ConfigureSyncfusionCore)
44- Creating basic SfExpander instance
45- Defining Header and Content views
46- Using IsExpanded property to control initial state
47- Complete invoice example with multiple expanders
48- Running your first expander application
49
50### Header and Content Customization
51📄 **Read:** [references/header-content-customization.md](references/header-content-customization.md)
52
53When to read: Customizing header and content sections with layouts and views
54- Loading any UI view in Header and Content properties
55- Using Grid layouts with icons and labels
56- Icon integration with font families
57- Multi-expander layouts (invoice with multiple sections)
58- Best practices for content structure
59- Avoiding common pitfalls (Label wrapping in containers)
60
61### Animation and Events
62📄 **Read:** [references/animation-events.md](references/animation-events.md)
63
64When to read: Controlling animation behavior and handling expand/collapse events
65- AnimationDuration property (default: 300ms)
66- AnimationEasing property (Linear, SinOut, etc.)
67- Programmatic control with IsExpanded property
68- Expanding event: Triggered before expansion (cancellable)
69- Expanded event: Triggered after expansion completes
70- Collapsing event: Triggered before collapse (cancellable)
71- Collapsed event: Triggered after collapse completes
72- Event handler examples with cancellation logic
73
74### Appearance and Styling
75📄 **Read:** [references/appearance-styling.md](references/appearance-styling.md)
76
77When to read: Customizing header appearance, colors, icons, and Visual State Manager styling
78- HeaderIconPosition property (Start, End)
79- HeaderBackground color customization
80- HeaderIconColor customization
81- Visual State Manager (VSM) states: Expanded, Collapsed, PointerOver, Normal
82- Dynamic appearance changes based on expander state
83- Complete VSM examples with color transitions
84
85### Liquid Glass Effect
86📄 **Read:** [references/liquid-glass-effect.md](references/liquid-glass-effect.md)
87
88When to read: Applying modern translucent designs with adaptive color tinting
89- When to use liquid glass effect (premium UX applications)
90- Wrapping SfExpander inside SfGlassEffectView
91- Setting EnableLiquidGlassEffect="True" on expander
92- Using Background="Transparent" for glass effect
93- Complete invoice example with liquid glass
94- Platform requirements: .NET 10+, macOS 26+, iOS 26+
95- Multiple expanders with consistent glass effect
96
gabrielmoreira