vael-ui v0.3.10

Gestures

PullToRefresh

A pull-down gesture at the top of a scroll container that triggers a refresh.

Install

import { PullToRefresh } from 'vael-ui'

Playground

  • Row 1
  • Row 2
  • Row 3
  • Row 4
  • Row 5
  • Row 6
  • Row 7
  • Row 8
import { PullToRefresh } from 'vael-ui'

<PullToRefresh :threshold="0" :maxPull="0">PullToRefresh</PullToRefresh>

Props

NameTypeDefaultDescription
onRefresh() => void | Promise<void>
thresholdnumber | undefinedHow far to pull (in pixels) before the refresh triggers.
maxPullnumber | undefinedMaximum pull distance (in pixels) allowed before clamping.
scrollElHTMLElement | { el: HTMLElement | null; } | null | undefinedDetects gestures on this element instead of the root, for dropping into an existing scrollable layout as a thin wrapper. Defaults to the root, which then owns scrolling itself (`overflow-y: auto`); passing one leaves the root's own overflow untouched.
uiPartial<{ root: UiPartValue; zone: UiPartValue; indicator: UiPartValue; bubble: UiPartValue; label: UiPartValue; }> | undefined

Slots

NameTypeDescription
defaultany
indicator{ state: PullToRefreshState; progress: number; pullDistance: number; }

Events

No events.

Exposed

NameTypeDescription
elHTMLElement | null
statePullToRefreshState
progressnumber
refresh() => Promise<void>