# PullToRefresh

Source: https://lumeo.nativ.sh/components/pull-to-refresh

# 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

Preview Code

Basic Pull to Refresh

Pull down to refresh · Count: 0

Item 1

Item 2

Item 3

Item 4

Item 5

Copy Code

Preview Code

Custom Threshold and Max Pull

Threshold 50 px · Count: 0

Row 1

Row 2

Row 3

Row 4

Copy Code

## 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](/components/swipe-actions) — Reveal contextual actions by swiping a list row horizontally
-   [TouchRipple](/components/touch-ripple) — Material-style touch feedback for tappable elements
-   [ScrollArea](/components/scroll-area) — Custom-styled scroll container for overflow content