Progress Bar
<cs-progress-bar>
Progress bars show how far along an ongoing operation is as a horizontal fill. Use them for file uploads, multi-step flows, or any task with measurable progress.
Examples
Label
Use the label attribute to tell assistive devices how to announce the progress bar.
Indeterminate
Add the indeterminate attribute when an operation is pending but its progress can’t be measured. In this state, value is ignored and the label, if present, isn’t shown.
Customizing
Set the --track-height custom property to change the bar’s thickness, and --track-color / --indicator-color to recolor it.
Showing Values
Use the default slot to show a value inside the bar.
API
Importing
If you're using the autoloader or a hosted project, components load on demand — no manual import needed. To cherry-pick this component, use one of the following snippets.
import '@cruglobal/cornerstone-components/components/progress-bar/progress-bar.js';
import './cornerstone/components/progress-bar/progress-bar.js';
import CsProgressBar from '@cruglobal/cornerstone-components/react/progress-bar/index.js';
Slots
Learn more about using slots.
| Name | Description |
|---|---|
| (default) | A label to show inside the progress indicator. |
Attributes & Properties
Learn more about attributes and properties.
| Property | Attribute | Description | Type | Default | Reflects |
|---|---|---|---|---|---|
indeterminate | indeterminate | When true, percentage is ignored, the label is hidden, and the progress bar is drawn in an indeterminate state. | boolean | false | Yes |
label | label | A custom label for assistive devices. | string | '' | — |
value | value | The current progress as a percentage, 0 to 100. | number | 0 | Yes |
CSS Custom Properties
Learn more about CSS custom properties.
| Name | Description | Default |
|---|---|---|
--indicator-color | The color of the indicator. | var(--cs-color-brand-fill-loud) |
--track-color | The color of the track. | var(--cs-color-neutral-fill-normal) |
--track-height | The height of the track. | 1rem |
CSS Parts
Learn more about CSS parts.
| Name | Description | CSS selector |
|---|---|---|
indicator | The progress bar's indicator. | ::part(indicator) |
label | The progress bar's label. | ::part(label) |
progress-bar | The component's outer wrapper. | ::part(progress-bar) |

