Updated
Gooey Refresh
ProCustomize
Threshold72px
Max pull150px
Min duration900ms
Color
Gap8px
Fade56px
Installation
ProGooey Refresh is a Pro component
Sign in to see the source, or install it with a license key. The live preview and props above are free to explore.
Install with a key
- Add the Pro registry to
components.json:components.json { "registries": { "@uibrik-pro": { "url": "https://uibrik.com/r/pro/{name}.json", "headers": { "Authorization": "Bearer ${UIBRIK_LICENSE}" } } } } - Put your key in
.env.localand add that file to.gitignore:.env.local UIBRIK_LICENSE=your-license-key - Install it:
Terminal npx shadcn@latest add @uibrik-pro/gooey-refresh
Loading your installation…
Usage
import { GooeyRefresh } from "@/components/uibrik/gooey-refresh/gooey-refresh";<GooeyRefresh items={…} renderItem={(item, index) => {}} onRefresh={() => {}} threshold={72} maxPull={150} minDuration={900} color="" gap={8} fade={56} wheel aria-label="Updates" contentClassName="px-3 py-3"/>Where to use Gooey Refresh
Feeds and inboxes
Pulling a feed for new posts or mail shows each new item arriving as its own droplet.
Pairs with Swipe Rows and Notification Center
Activity and logs
A pull on an activity list makes fetching the latest events feel physical, with no button to find.
Pairs with Activity Log and Event Feed
Mobile web apps
Touch, mouse drag and trackpad all pull, so one list works in a phone web view and on desktop.
Props
GooeyRefresh- threshold
- Type number
- 72
- How far the list travels before the drop snaps off.
- maxPull
- Type number
- 150
- Longest the list can be pulled; the pull gets heavier toward it.
- minDuration
- Type number
- 900
- Shortest time the spinner shows, so a fast refresh still reads.
- color
- Type string
- ""
- Blob colour; empty uses the text colour.
- gap
- Type number
- 8
- Space between rows.
- fade
- Type number
- 56
- Soft fade where rows run off the bottom edge; 0 turns it off.
- wheel
- Type boolean
- true
- Pull with the mouse wheel or trackpad when the list is at the top.
- itemsrequired
- Type T[] (T extends { id: string })
- –
- Rows to show. Add new ones to the start inside onRefresh.
- renderItemrequired
- Type (item: T, index: number) => ReactNode
- –
- Renders one row.
- onRefreshrequired
- Type () => Promise<void> | void
- –
- Runs when a pull is released past the threshold. Rows whose ids are new when it settles fall in as droplets.
- ref
- Type Ref<{ refresh(): void }>
- –
- refresh() plays the whole pull, for a button or a first-visit hint.
- aria-label
- Type string
- "Feed"
- Accessible name for the list.
- className
- Type string
- –
- Classes for the wrapper. Give it a height; the list scrolls inside.
- contentClassName
- Type string
- –
- Classes for the element holding the rows, such as padding.