PullToRefresh
An iOS/Android-style pull-down-to-refresh wrapper that fires a callback when the user drags past a configurable threshold.
When to Use
- Mobile feeds, timelines, or lists where users expect to pull down to load fresh data
- Any scrollable panel that benefits from a gesture-driven reload instead of a visible refresh button
- News, social, or activity streams presented in a fixed-height container on touch devices
- Replacing manual "Reload" buttons with an intuitive gesture on hybrid mobile/desktop apps
- Content areas where polling is undesirable and user-triggered refresh is preferred
Pull down to refresh · Count: 0
Item 1
Item 2
Item 3
Item 4
Item 5
Threshold 50 px · Count: 0
Row 1
Row 2
Row 3
Row 4
API Reference
PullToRefresh
| Property | Type | Default | Description |
|---|---|---|---|
| ChildContent | RenderFragment? | — | The scrollable content rendered inside the pull container. |
| OnRefresh | EventCallback | — | Async callback invoked when the user releases past the threshold. The spinner remains visible until the callback completes. |
| ThresholdPx | double | 80 | Minimum pull distance (after rubber-band damping) required to trigger a refresh. |
| MaxPullPx | double | 120 | Maximum visual offset the content travels before the rubber-band clamps it. |
| Class | string? | null | Additional CSS classes applied to the scroll container root element. |
Related Components
- SwipeActions — Reveal contextual actions by swiping a list row horizontally
- TouchRipple — Material-style touch feedback for tappable elements
- ScrollArea — Custom-styled scroll container for overflow content