mcpField
S
syncfusion-maui-toolkit-accordion

syncfusion-maui-toolkit-accordion

github.com/syncfusionDesign & UI3947 installsUpdated 7w ago
Repository

About syncfusion-maui-toolkit-accordion

An implementation guide for .NET MAUI developers building Syncfusion’s SfAccordion. It covers a vertical collapsible panel with single or multiple expansion, data binding, animations, and event handling.

Key features

  1. 01Single or multiple expansion modes
  2. 02BindableLayout data binding
  3. 03Custom animation duration and easing
  4. 04Color, icon, and visual state styling
  5. 05Expand and collapse event handling
  6. 06Programmatic scroll positioning

Use cases

  1. 01Build FAQs with expandable answers
  2. 02Display employee directories or detailed records
  3. 03Present grouped settings options
  4. 04Show collapsible hierarchical data

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/syncfusion/maui-toolkit-ui-components-skills --skill syncfusion-maui-toolkit-accordion

After installing, type/syncfusion-maui-toolkit-accordionin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
advanced-features.md
appearance-customization.md
data-binding.md
events.md
getting-started.md

Details

From the project README

Implementing Syncfusion .NET MAUI Accordion

A comprehensive guide for implementing the Syncfusion .NET MAUI Accordion (SfAccordion) - a vertically collapsible panel control that allows users to expand or collapse one or multiple items simultaneously.

When to Use This Skill

Use this skill when you need to:

  • Implement collapsible/expandable content sections in .NET MAUI
  • Display employee directories, contact lists, or detailed records
  • Create FAQ sections with expandable answers
  • Build settings panels with grouped options
  • Show hierarchical data with expand/collapse behavior
  • Implement vertical expander panels
  • Bind accordion items to ObservableCollection data sources
  • Customize accordion appearance with themes and Visual States
  • Handle expansion/collapse events with validation

Component Overview

The .NET MAUI Accordion provides a vertically stacked interface where each item consists of a header and content section. Users can tap headers to expand/collapse content, making it ideal for displaying hierarchical information, FAQs, employee directories, or any scenario requiring space-efficient grouped content display.

  • Single or multiple item expansion modes
  • Data binding with .NET MAUI BindableLayout
  • Customizable animations (duration and easing)
  • Rich appearance customization (colors, icons, Visual States)
  • Event handling for expand/collapse actions
  • Programmatic scroll control

Documentation and Navigation Guide

Getting Started

📄 Read: references/getting-started.md

  • Installation of Syncfusion.Maui.Toolkit NuGet package
  • Handler registration with ConfigureSyncfusionToolkit()
  • Basic SfAccordion setup in XAML and C#
  • Creating AccordionItem with Header and Content
  • Expand modes: Single, Multiple, MultipleOrNone
  • Animation duration and easing customization
  • Item spacing configuration
  • Auto scroll position settings
  • BringIntoView method for programmatic scrolling
Data Binding with BindableLayout

📄 Read: references/data-binding.md

  • Creating data models with INotifyPropertyChanged
  • Setting up ObservableCollection for accordion items
  • Configuring BindingContext
  • Using BindableLayout.ItemsSource for data binding
  • Defining BindableLayout.ItemTemplate for item appearance
  • Two-way binding with IsExpanded property
  • Dynamic item generation from collections
  • Complete employee list example with data binding
Appearance Customization

📄 Read: references/appearance-customization.md

  • Header icon position (Start, End)
  • Header background color customization
  • Icon color customization
  • Visual State Manager for state-based styling
    • Expanded and Collapsed states
    • Focused state for keyboard navigation
    • PointerOver state for hover effects
    • Normal state styling
  • Complete Visual State styling examples
Events and Interaction

📄 Read: references/events.md

  • Expanding event (cancellable)
  • Expanded event (completion notification)
  • Collapsing event (cancellable)
  • Collapsed event (completion notification)
  • Event arguments: Cancel and Index properties
  • Validation before expand/collapse
  • Common event handling patterns
Advanced Features

📄 Read: references/advanced-features.md

  • Auto scroll position (Top, MakeVisible)
  • BringIntoView for programmatic scrolling
  • Grid layout considerations with Height=Auto
  • HorizontalOptions and VerticalOptions best practices

Comments

Markdown supported