Progress
Show percent completion with a progress bar
import { useEffect, useState } from 'react'import type { SizeTokens } from 'tamagui'import { Button, Paragraph, Progress, Slider, XStack, YStack } from 'tamagui'export function ProgressDemo() {const [size, setSize] = useState(4)const [progress, setProgress] = useState(20)const sizeProp = `$${size}` as SizeTokensuseEffect(() => {const timer = setTimeout(() => setProgress(60), 1000)return () => {clearTimeout(timer)}}, [])return (<><YStack height={60} alignItems="center" space><Paragraph height={30} opacity={0.5}>Size: {size}</Paragraph><Progress size={sizeProp} value={progress}><Progress.Indicator animation="bouncy" /></Progress></YStack><XStack alignItems="center" space position="absolute" bottom="$3" left="$4" $xxs={{ display: 'none' }} ><Slider size="$2" width={130} defaultValue={[4]} min={2} max={6} step={1} onValueChange={([val]) => { setSize(val) }} ><Slider.Track borderWidth={1} borderColor="$color5"><Slider.TrackActive /></Slider.Track><Slider.Thumb circular index={0} /></Slider><Button size="$2" onPress={() => setProgress((prev) => (prev + 20) % 100)}>Load</Button></XStack></>)}
Features
Sizable, themeable, animatable.
Composable component API for complete control.
Adheres to the progressbar role requirements
Installation
Progress is already installed in tamagui
, or you can install it independently:
yarn @tamagui/progress
Usage
The value
property controls the percent, but you can override it by adjusting the x
property.
import { Button, Progress } from 'tamagui'export default () => (<Progress value={60}><Progress.Indicator animation="bouncy" /></Progress>)
API Reference
Progress
Progress extends ThemeableStack, getting Tamagui standard props, plus:
Props
size
"small" | "large"
value
number | null
Control the percent progress.
max
number
unstyled
boolean
When true will remove all default styles
Progress.Indicator
Progress.Indicator
extends ThemeableStack, getting Tamagui standard props.
Props
unstyled
boolean
When true will remove all default styles
Previous
Label
Next
RadioGroup