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