Implementing .NET MAUI ListView
A comprehensive skill for implementing, customizing, and optimizing the Syncfusion .NET MAUI ListView (SfListView) component. The ListView displays collections of data with support for layouts, sorting, filtering, grouping, selection, and rich customization options.
When to Use This Skill
Use this skill when you need to:
- Display Collections: Show lists of data items from any data source (ObservableCollection, List, etc.)
- Data Operations: Implement sorting, filtering, or grouping of list items
- Custom Layouts: Create linear or grid layouts with single or multiple columns
- User Interaction: Enable item selection (single/multiple), tapping, long-press, or double-tap
- Advanced Features: Add swipe actions, drag-and-drop reordering, pull-to-refresh, or load more
- Customization: Design custom item templates, headers, footers, or group headers
- Performance: Optimize list rendering for large datasets with virtualization
- MVVM Patterns: Implement ListView with data binding, commands, and ViewModels
Common Scenarios:
- Product catalogs, contact lists, inbox/email lists
- News feeds, social media posts, photo galleries
- Settings pages, navigation menus, file browsers
- Task lists, order history, transaction records
- Any scrollable collection of similar items
Component Overview
SfListView is a high-performance, feature-rich list control that:
- Renders data items using built-in or custom templates
- Supports optimized view reusing strategy for smooth scrolling
- Provides linear and grid layouts with orientation support
- Enables data operations (sort, filter, group) without re-binding
- Offers multiple selection modes and gestures
- Includes sticky headers, footers, and group headers
- Supports item swipe actions and drag-and-drop
- Handles large datasets efficiently with virtualization
Documentation and Navigation Guide
Getting Started
📄 Read: references/getting-started.md
- NuGet package setup (Syncfusion.Maui.ListView)
- Registering handlers in MauiProgram.cs
- Creating your first ListView
- Data models and ViewModels
- Basic data binding and item templates
Layout Options
📄 Read: references/layouts.md
- Linear layout (vertical/horizontal)
- Grid layout with SpanCount
- Changing layouts dynamically
- Responsive column count based on screen size
- Layout best practices
Data Operations
📄 Read: references/data-operations.md
- Sorting with SortDescriptor (ascending/descending, custom comparers)
- Filtering with predicates and RefreshFilter
- Grouping with GroupDescriptor and sticky group headers
- Combining multiple operations
- Performance considerations
Selection
📄 Read: references/selection.md
- Selection modes (None, Single, SingleDeselect, Multiple, Extended)
- Selection gestures (Tap, DoubleTap, Hold)
- SelectedItem and SelectedItems properties
- Selection events (SelectionChanging, SelectionChanged)
- Programmatic selection
- Customizing selection appearance
Item Customization
📄 Read: references/item-customization.md
- Custom item templates with ItemTemplate
- DataTemplateSelector for dynamic templates
- Item sizing (fixed, auto-fit, dynamic)
- Item appearance (borders, spacing, visual effects)
- Liquid glass effect
- Advanced customization techniques
Headers and Footers
📄 Read: references/headers-footers.md
- Adding HeaderTemplate and FooterTemplate
- Sticky headers and footers (IsStickyHeader, IsStickyFooter)
- Group headers with GroupHeaderTemplate
- Dynamic header/footer content
- Common header/footer patterns
Interactive Features
📄 Read: references/interactive-features.md
- Swipe actions (StartSwipeTemplate, EndSwipeTemplate)
- Swipe events and common patterns (delete, archive)
- Drag and drop (DragStartMode, drag/drop events)
- Reordering items within list
- Cross-list drag and drop
Load More and Pull to Refresh
📄 Read: references/load-more-pull-refresh.md
- Load more options (auto/manual)
- LoadMoreCommand and LoadMoreTemplate
- Pull to refresh
- Best practices for large datasets
Scrolling
📄 Read: references/scrolling.md
- Scroll methods (ScrollTo, ScrollToRowIndex)
- ScrollBarVisibility property
- Programmatic scrolling
- ListView without virtualization
- Performance optimization for scrolling
Right-to-Left (RTL) Support
📄 Read: references/rtl.md
- Right-to-Left (RTL) layout support
- FlowDirection property
- Testing RTL layouts
MVVM Patterns
📄 Read: references/mvvm-patterns.md
- MVVM architecture with ListView
- INotifyPropertyChanged and ObservableCollection
- Commands (TapCommand, LongPressCommand)
- Data binding patterns
- Handling user actions in MVVM
- Complete MVVM example
Events and Performance
📄 Read: references/events-performance.md
- Lifecycle events (Loaded)
- Interaction events (ItemTapped, ItemDoubleTapped, ItemLongPress)
- ItemAppearing and ItemDisappearing events
- Performance optimization techniques
- Using BeginInit/EndInit for batch updates
- RefreshView method
- Troubleshooting performance issues
1---2name: syncfusion-maui-listview3description: Implements Syncfusion .NET MAUI ListView (SfListView). Use when displaying lists or collections of data in MAUI applications, implementing data grids, creating scrollable item lists, or adding sorting/filtering/grouping. Covers item selection, layout customization, swipe actions, pull-to-refresh, load more, and drag-drop items.4---5
6# Implementing .NET MAUI ListView
7
8A comprehensive skill for implementing, customizing, and optimizing the Syncfusion .NET MAUI ListView (SfListView) component. The ListView displays collections of data with support for layouts, sorting, filtering, grouping, selection, and rich customization options.
9
10## When to Use This Skill
11
12Use this skill when you need to:
13
14- **Display Collections:** Show lists of data items from any data source (ObservableCollection, List, etc.)
15- **Data Operations:** Implement sorting, filtering, or grouping of list items
16- **Custom Layouts:** Create linear or grid layouts with single or multiple columns
17- **User Interaction:** Enable item selection (single/multiple), tapping, long-press, or double-tap
18- **Advanced Features:** Add swipe actions, drag-and-drop reordering, pull-to-refresh, or load more
19- **Customization:** Design custom item templates, headers, footers, or group headers
20- **Performance:** Optimize list rendering for large datasets with virtualization
21- **MVVM Patterns:** Implement ListView with data binding, commands, and ViewModels
22
23**Common Scenarios:**
24- Product catalogs, contact lists, inbox/email lists
25- News feeds, social media posts, photo galleries
26- Settings pages, navigation menus, file browsers
27- Task lists, order history, transaction records
28- Any scrollable collection of similar items
29
30## Component Overview
31
32**SfListView** is a high-performance, feature-rich list control that:
33- Renders data items using built-in or custom templates
34- Supports optimized view reusing strategy for smooth scrolling
35- Provides linear and grid layouts with orientation support
36- Enables data operations (sort, filter, group) without re-binding
37- Offers multiple selection modes and gestures
38- Includes sticky headers, footers, and group headers
39- Supports item swipe actions and drag-and-drop
40- Handles large datasets efficiently with virtualization
41
42
43## Documentation and Navigation Guide
44
45### Getting Started
46📄 **Read:** [references/getting-started.md](references/getting-started.md)
47- NuGet package setup (Syncfusion.Maui.ListView)
48- Registering handlers in MauiProgram.cs
49- Creating your first ListView
50- Data models and ViewModels
51- Basic data binding and item templates
52
53### Layout Options
54📄 **Read:** [references/layouts.md](references/layouts.md)
55- Linear layout (vertical/horizontal)
56- Grid layout with SpanCount
57- Changing layouts dynamically
58- Responsive column count based on screen size
59- Layout best practices
60
61### Data Operations
62📄 **Read:** [references/data-operations.md](references/data-operations.md)
63- Sorting with SortDescriptor (ascending/descending, custom comparers)
64- Filtering with predicates and RefreshFilter
65- Grouping with GroupDescriptor and sticky group headers
66- Combining multiple operations
67- Performance considerations
68
69### Selection
70📄 **Read:** [references/selection.md](references/selection.md)
71- Selection modes (None, Single, SingleDeselect, Multiple, Extended)
72- Selection gestures (Tap, DoubleTap, Hold)
73- SelectedItem and SelectedItems properties
74- Selection events (SelectionChanging, SelectionChanged)
75- Programmatic selection
76- Customizing selection appearance
77
78### Item Customization
79📄 **Read:** [references/item-customization.md](references/item-customization.md)
80- Custom item templates with ItemTemplate
81- DataTemplateSelector for dynamic templates
82- Item sizing (fixed, auto-fit, dynamic)
83- Item appearance (borders, spacing, visual effects)
84- Liquid glass effect
85- Advanced customization techniques
86
87### Headers and Footers
88📄 **Read:** [references/headers-footers.md](references/headers-footers.md)
89- Adding HeaderTemplate and FooterTemplate
90- Sticky headers and footers (IsStickyHeader, IsStickyFooter)
91- Group headers with GroupHeaderTemplate
92- Dynamic header/footer content
93- Common header/footer patterns
94
95### Interactive Features
96📄 **Read:** [references/interactive-features.md](references/interactive-features.md)
97- Swipe actions (StartSwipeTemplate, EndSwipeTemplate)
98- Swipe events and common patterns (delete, archive)
99- Drag and drop (DragStartMode, drag/drop events)
100- Reordering items within list
101- Cross-list drag and drop
102
103### Load More and Pull to Refresh
104📄 **Read:** [references/load-more-pull-refresh.md](references/load-more-pull-refresh.md)
105- Load more options (auto/manual)
106- LoadMoreCommand and LoadMoreTemplate
107- Pull to refresh
108- Best practices for large datasets
109
110### Scrolling
111📄 **Read:** [references/scrolling.md](references/scrolling.md)
112- Scroll methods (ScrollTo, ScrollToRowIndex)
113- ScrollBarVisibility property
114- Programmatic scrolling
115- ListView without virtualization
116- Performance optimization for scrolling
117
118### Right-to-Left (RTL) Support
119📄 **Read:** [references/rtl.md](references/rtl.md)
120- Right-to-Left (RTL) layout support
121- FlowDirection property
122- Testing RTL layouts
123
124### MVVM Patterns
125📄 **Read:** [references/mvvm-patterns.md](references/mvvm-patterns.md)
126- MVVM architecture with ListView
127- INotifyPropertyChanged and ObservableCollection
128- Commands (TapCommand, LongPressCommand)
129- Data binding patterns
130- Handling user actions in MVVM
131- Complete MVVM example
132
133### Events and Performance
134📄 **Read:** [references/events-performance.md](references/events-performance.md)
135- Lifecycle events (Loaded)
136- Interaction events (ItemTapped, ItemDoubleTapped, ItemLongPress)
137- ItemAppearing and ItemDisappearing events
138- Performance optimization techniques
139- Using BeginInit/EndInit for batch updates
140- RefreshView method
141- Troubleshooting performance issues
142
gabrielmoreira