Overview of .NET MAUI PullToRefresh
22 Jul 20267 minutes to read
Syncfusion® .NET MAUI PullToRefresh is a refresh control that enables users to interact with and refresh content using a pull gesture. The control displays a progress indicator as the user pulls the content. Once the configured pull threshold is reached and the gesture is released, the refresh action is triggered.
The refresh distance required to trigger an update is configurable through the PullingThreshold property. This allows you to adjust the pull experience based on your application’s needs.
Common properties and commands
The following properties are commonly used when working with SfPullToRefresh:
| Property | Description |
|---|---|
IsRefreshing |
Indicates whether a refresh operation is currently running. |
RefreshCommand |
Executes a command when a refresh is triggered. |
RefreshCommandParameter |
Passes data to the refresh command. |
PullingThreshold |
Specifies the distance that must be pulled before refresh is triggered. |
TransitionMode |
Configures the animation behavior used during refresh transitions. |
PullingView |
Displays a custom view while the user is pulling. |
RefreshingView |
Displays a custom view while a refresh operation is running. |
Business use cases
- Mobile applications that require refreshing list or grid data using pull gestures.
- Social and content apps that update feeds, messages, or notifications dynamically.
- Dashboard applications that update metrics, data points, or live information on demand.
- Business and enterprise apps that allow users to reload data efficiently without navigating away from the screen.
Key features
Transition mode
Configure animation behavior between the pull gesture and refresh indicator using the TransitionMode property.
For available transition options and examples, refer to the customization documentation:
- https://help.syncfusion.com/maui/pull-to-refresh/customization
Pullable content
SfPullToRefresh acts as a container that wraps the content to be refreshed. The content is placed inside the PullableContent property.
Commonly used pullable content includes:
- ListView
- DataGrid
- CollectionView
- Layout containers such as Grid, StackLayout, and VerticalStackLayout
- Custom views
Appearance customization
Customize the appearance of the refresh indicator through properties such as:
ProgressColorProgressThicknessProgressBackgroundProgressCircleSize
View templating
Display custom UI elements during pulling and refreshing operations using:
PullingViewRefreshingView
These template-based properties enable you to replace the default refresh visuals with custom content and branding.
Globalization
The following table summarizes globalization and accessibility support available in this control.
Full Support
Not Applicable
| Control | Localization | RTL | Time zone | Screen reader | Keyboard navigation |
|---|---|---|---|---|---|
| Pull To Refresh | |
|
|
|
|
RTL Support
SfPullToRefresh provides RTL (Right-to-Left) layout support. RTL support applies to the control’s layout and interaction behavior when the application flow direction is configured for right-to-left languages.
Accessibility testing
Since SfPullToRefresh is a gesture-based container, screen reader and keyboard navigation support are generally dependent on the child content hosted within the control.
To validate accessibility behavior:
- Test with platform accessibility tools such as TalkBack (Android), VoiceOver (iOS), and Narrator (Windows).
- Verify that child controls expose appropriate accessibility properties.
- Verify focus order and announced content within the hosted controls.
For additional accessibility guidance, see the .NET MAUI accessibility documentation and platform accessibility guidelines.
Related controls
- ListView for displaying refreshable data in list-based layouts.
- DataGrid for refreshing tabular data with grid-based views.
- Busy Indicator for showing loading feedback during refresh operations.
See Also
- Getting Started shows a step-by-step guide to begin using the PullToRefresh control.
- MVVM Support explains how to use commands, data binding, and refresh state management.
- Customization explains how to customize appearance, templates, and interaction behavior.
- UI Kit provides interactive demos and ready-made UI examples.
Resources
The following resources provide additional learning materials. Internal documentation links are listed above where available, while the following links point to external Syncfusion resources.