Kaapi UI
← Back to Design System

Progress Indicators

A visual indicator showing the completion status of a task or operation.

Base Example

<ProgressBar value={45} />

Text right

45%
<ProgressBar value={45} labelPosition="right" />

Text bottom

20%
<ProgressBar value={20} labelPosition="bottom" />

Text top floating

20%
<ProgressBar value={20} labelPosition="top-floating" />

Text bottom floating

80%
<ProgressBar value={80} labelPosition="bottom-floating" />

Circle progress bar

40%
40%
40%
<ProgressBarCircle size="xxs" value={40} />
<ProgressBarCircle size="xs" value={40} />
<ProgressBarCircle size="sm" value={40} />

Circle progress bar label

40%
Progrès
Progrès
40%
Progrès
40%
<ProgressBarCircle size="xxs" value={40} label="Progrès" />
<ProgressBarCircle size="xs" value={40} label="Progrès" />
<ProgressBarCircle size="sm" value={40} label="Progrès" />

Half circle progress bar

60%
60%
60%
<ProgressBarHalfCircle size="xxs" value={60} />
<ProgressBarHalfCircle size="xs" value={60} />
<ProgressBarHalfCircle size="sm" value={60} />

Half circle progress bar label

60%
Objectif
Objectif
60%
Objectif
60%
<ProgressBarHalfCircle size="xxs" value={60} label="Objectif" />
<ProgressBarHalfCircle size="xs" value={60} label="Objectif" />
<ProgressBarHalfCircle size="sm" value={60} label="Objectif" />

API Reference

PropsTypeDefaultDescription
valuenumber-The current value of the progress indicator.
min?number0The minimum value of the progress indicator.
max?number100The maximum value of the progress indicator.
labelPosition?"right" | "bottom" | "top-floating" | "bottom-floating"-Label position for the progress bar.
getValueLabel?function (value: number, max: number) => string-A function to get the accessible label text representing the current value in a human-readable format for the progress bar.
size?'xxs' | 'xs' | 'sm' | 'md' | 'lg'xxsSize for circles progress indicators.
Label?string-Accessible label for circles progress indicator.
className?string-Additional CSS classes to apply to the progress indicator.