Components
- Accordion
- Action Bar
- Alert Dialog
- Alert
- Announcement
- Aspect Ratio
- Autocomplete
- Avatar
- Badge
- Bottom Navigation
- Breadcrumb
- Button Group
- Button
- Calendar
- Card
- Carousel
- Chart
- Checkbox
- Circular Progress
- Circular Slider
- Clipboard
- Collapsible
- Color Picker
- Combobox
- Command
- Context Menu
- Data List
- Date Picker
- Dialog
- Drawer
- Editable
- Field
- File Upload
- Float
- Floating Panel
- Frame
- Hint
- Hover Card
- Image Cropper
- Input Group
- Input OTP
- Input
- Item
- Kbd
- Link Overlay
- Listbox
- Marquee
- Menu
- Native Select
- Number Input
- Pagination
- Popover
- Progress
- Prose
- QR Code
- Radio Group
- Rating
- Resizable
- Scroll Area
- Segment Group
- Select
- Separator
- Sheet
- Sidebar
- Signature Pad
- Skeleton
- Skip Nav
- Slider
- Spinner
- Status
- Steps
- Switch
- Table
- Tabs
- Textarea
- Timer
- Toast
- Toggle Group
- Toggle Tooltip
- Toggle
- Tooltip
- Tour
- Tree View
Installation
pnpm dlx shadcn@latest add https://shark.vini.one/r/circular-progress.json
Usage
import { CircularProgress } from "@/components/ui/circular-progress";
<CircularProgress value={66} />
Controlled
Use value to control the progress manually.
Examples
With value
Use <CircularProgressValue /> to render the current value text.
66%
Indeterminate
Use the indeterminate prop when the completion percentage is unknown.
Custom Size
Use the size prop to set the circle diameter in pixels.
Custom Thickness
Use the thickness prop to control the ring stroke width.
API Reference
CircularProgress
Root element of the circular progress indicator.
| Prop | Type | Default |
|---|---|---|
value | number | null | - |
defaultValue | number | - |
onValueChange | (details: ValueChangeDetails) => void | - |
indeterminate | boolean | false |
size | number | 32 |
thickness | number | 4 |
className | string | - |
CircularProgressValue
Displays the current progress value text.
| Prop | Type | Default |
|---|---|---|
className | string | - |
For a complete list of props, see the Ark UI documentation.