Progress Ring Group
<wa-progress-ring-group>
Progress ring groups render multiple progress rings together in nested or stacked layouts.
Examples
Basic usage
Render multiple wa-progress-ring children inside the group. Labels are extracted from each child's label attribute.
Adjust the size and gap
Use size to control the outer diameter and gap to increase the space between nested rings.
Color the labels from each ring
Use the colored-labels attribute to let each extracted label inherit its ring's indicator color.
Switch to stacked mode
Use mode="stacked" when you want all rings to share the same diameter and rotate around one another.
Notes
- The group keeps child labels in sync when ring
value,label, or inlinestylechanges after initial render. coloredLabelsremains the JavaScript property name; usecolored-labelsin HTML.- This is a Yoummday-owned component and has no runtime alias for
sl-progress-ring-group.
API
Importing
If you're using the autoloader or a hosted project, components load on demand — no manual import needed. To cherry-pick a component manually, use one of the following snippets.
Import this component directly from the CDN:
import 'https://cdn.yoummday.com/packages/@yoummday/webawesome/0.5.1/dist/components/progress-ring-group/progress-ring-group.js';
After installing Web Awesome via npm, import this component:
import '@yoummday/webawesome/dist/components/progress-ring-group/progress-ring-group.js';
If you're self-hosting Web Awesome, import this component from your server:
import './webawesome/dist/components/progress-ring-group/progress-ring-group.js';
To import this component for React 18 or below, use the following code:
import WaProgressRingGroup from '@yoummday/webawesome/dist/react/progress-ring-group/index.js';
Slots
Learn more about using slots.
| Name | Description |
|---|---|
| (default) | Multiple <wa-progress-ring> elements to include in the group. |
Attributes & Properties
Learn more about attributes and properties.
| Name | Description | Reflects |
|---|---|---|
coloredLabelscolored-labels |
Shows the extracted labels in their respective indicator color.
Type
boolean
Default
false
|
|
gapgap |
The gap between each ring in pixels when rendered in nested mode.
Type
number
Default
2
|
|
modemode |
The display mode.
Type
'nested' | 'stacked'
Default
'nested'
|
|
sizesize |
The diameter of the rings in pixels.
Type
number
Default
128
|
CSS Parts
Learn more about CSS parts.
| Name | Description | CSS selector |
|---|---|---|
label |
An extracted label from a child progress ring. |
::part(label)
|
labels |
The labels container rendered in the center of the group. |
::part(labels)
|
progress-ring-group |
The component's outer wrapper. |
::part(progress-ring-group)
|
base |
The component's outer wrapper. |
::part(base)
|
Dependencies
This component automatically imports the following elements. Sub-dependencies, if any exist, will also be included in this list.