Progress Ring
<cs-progress-ring>
Progress rings show how far along a determinate operation is using a circular indicator. Use them as a compact alternative to progress bars when horizontal space is limited.
Examples
Label
Use the label attribute to tell assistive devices how to announce the progress ring.
Size
Use the --size custom property to set the diameter of the ring.
Track & Indicator Width
Use the --track-width and --indicator-width custom properties to set the width of the ring’s track and indicator independently.
Colors
Use the --track-color and --indicator-color custom properties to recolor the ring.
Showing Values
Use the default slot to show a value inside the ring.
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-ring/progress-ring.js';
import './cornerstone/components/progress-ring/progress-ring.js';
import CsProgressRing from '@cruglobal/cornerstone-components/react/progress-ring/index.js';
Slots
Learn more about using slots.
| Name | Description |
|---|---|
| (default) | A label to show inside the ring. |
Attributes & Properties
Learn more about attributes and properties.
| Property | Attribute | Description | Type | Default | Reflects |
|---|---|---|---|---|---|
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. | — |
--indicator-transition-duration | The duration of the indicator's transition when the value changes. | — |
--indicator-width | The width of the indicator. Defaults to the track width. | — |
--size | The diameter of the progress ring (cannot be a percentage). | — |
--track-color | The color of the track. | — |
--track-width | The width of the track. | — |
CSS Parts
Learn more about CSS parts.
| Name | Description | CSS selector |
|---|---|---|
indicator | The progress ring's indicator. | ::part(indicator) |
label | The progress ring label. | ::part(label) |
progress-ring | The component's outer wrapper. | ::part(progress-ring) |
track | The progress ring's track. | ::part(track) |

