Font Awesome Build Awesome
Try SSR Server-side rendering (SSR) generates component HTML on the server before the page loads, improving SEO and initial load time. Use the switch to see Web Awesome components render with and without SSR.
Search this website ⌘KCtrl+K Light Dark System Docs Select Color Scheme Default Awesome Shoelace Yoummday Light Yoummday Dark Active Brutalist Glossy Matter Mellow Playful Premium Tailspin Docs Select Theme View Project on GitHub Star Project on GitHub
Start Components Docs Help
Web Awesome Font Awesome Build Awesome
Search this site… /
Try SSR Server-side rendering (SSR) generates component HTML on the server before the page loads, improving SEO and initial load time. Use the switch to see Web Awesome components render with and without SSR.
Light Dark System Docs Select Color Scheme Default Awesome Shoelace Yoummday Light Yoummday Dark Active Brutalist Glossy Matter Mellow Playful Premium Tailspin Docs Select Theme

Getting Started

  • Installation
  • Usage
  • Forms
  • Localization
  • Frameworks
  • Using with AI
  • Figma Design Kit ProThis requires access to Web Awesome Pro
  • Server Rendering

Resources

  • Accessibility
  • Browser Support
  • Contributing
  • Patterns ProPatterns require access to Web Awesome Pro
  • Migrating from Shoelace
  • Visual Tests
  • Component Showcase
  • Changelog
  • Help & Support

Theming & Utilities

  • Overview
  • Built-in Themes
  • Color Palettes
  • Design Tokens
  • Customizing & Theming
  • CSS Utilities

Actions

  • Button
  • Button Group
  • Button Row
  • Copy Button
  • Dropdown
    • Dropdown Item

Forms

  • Checkbox
  • Checkbox Group
  • Color Picker
  • File Upload
  • Input
  • Known Date
  • Number Input
  • OTP Input
  • Radio Group
    • Radio
  • Rating
  • Select
    • Option
  • Slider
  • Switch
  • Textarea
  • Time Input

Layout

  • Accordion
    • Accordion Item
  • Card
  • Content Header
  • Details
  • Dialog
  • Divider
  • Drawer
  • Page
  • Page Header
  • Scroller
  • Split Panel

Navigation

  • Breadcrumb
    • Breadcrumb Item
  • Navigation Entry
  • Pagination
  • Tab Group
    • Tab
    • Tab Panel
  • Tree
    • Tree Item

Feedback

  • Badge
  • Callout
  • Empty State
  • Progress
  • Progress Bar
  • Progress Ring
  • Progress Ring Group
  • Skeleton
  • Spinner
  • Tag
  • Toast
    • Toast Item
  • Tooltip

Media

  • Animated Image
  • Avatar
  • Carousel
    • Carousel Item
  • Comparison
  • Icon
  • Markdown
  • QR Code
  • Zoomable Frame

Data Viz

  • Advanced Usage

Helpers

  • Animation
  • Format Bytes
  • Format Date
  • Format Number
  • Include
  • Intersection Observer
  • Mutation Observer
  • Popover
  • Popup
  • Random Content
  • Relative Time
  • Resize Observer

Progress Ring Group

  • Examples
  • Basic usage
  • Adjust the size and gap
  • Color the labels from each ring
  • Switch to stacked mode
  • Notes
  • API
  • Importing
  • Slots
  • Attributes & Properties
  • CSS Parts
  • Dependencies
On This Page...
  • Examples
  • Basic usage
  • Adjust the size and gap
  • Color the labels from each ring
  • Switch to stacked mode
  • Notes
  • API
  • Importing
  • Slots
  • Attributes & Properties
  • CSS Parts
  • Dependencies

Progress Ring Group

<wa-progress-ring-group>
Stable added Feedback Since ymmd-0.3

Progress ring groups render multiple progress rings together in nested or stacked layouts.

<wa-progress-ring-group colored-labels>
  <wa-progress-ring value="50" label="Profile" style="--indicator-color: tomato;"></wa-progress-ring>
  <wa-progress-ring value="25" label="Documents" style="--indicator-color: olive;"></wa-progress-ring>
</wa-progress-ring-group>

Examples

Link to This Section

Basic usage

Link to This Section

Render multiple wa-progress-ring children inside the group. Labels are extracted from each child's label attribute.

<wa-progress-ring-group>
  <wa-progress-ring value="50" label="50%"></wa-progress-ring>
  <wa-progress-ring value="25" label="25%"></wa-progress-ring>
</wa-progress-ring-group>

Adjust the size and gap

Link to This Section

Use size to control the outer diameter and gap to increase the space between nested rings.

<wa-progress-ring-group size="200" gap="8">
  <wa-progress-ring value="50" label="Signed"></wa-progress-ring>
  <wa-progress-ring value="25" label="Reviewed"></wa-progress-ring>
  <wa-progress-ring value="15" label="Paid"></wa-progress-ring>
</wa-progress-ring-group>

Color the labels from each ring

Link to This Section

Use the colored-labels attribute to let each extracted label inherit its ring's indicator color.

<wa-progress-ring-group colored-labels>
  <wa-progress-ring value="50" label="Tomato" style="--indicator-color: tomato;"></wa-progress-ring>
  <wa-progress-ring value="25" label="Olive" style="--indicator-color: olive;"></wa-progress-ring>
</wa-progress-ring-group>

Switch to stacked mode

Link to This Section

Use mode="stacked" when you want all rings to share the same diameter and rotate around one another.

<wa-progress-ring-group mode="stacked">
  <wa-progress-ring value="50" label="Core" style="--indicator-color: indigo;"></wa-progress-ring>
  <wa-progress-ring value="25" label="Add-on" style="--indicator-color: deeppink;"></wa-progress-ring>
</wa-progress-ring-group>

Notes

Link to This Section
  • The group keeps child labels in sync when ring value, label, or inline style changes after initial render.
  • coloredLabels remains the JavaScript property name; use colored-labels in HTML.
  • This is a Yoummday-owned component and has no runtime alias for sl-progress-ring-group.

API

Link to This Section

Importing

Link to This Section

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.

CDN npm Self-Hosted React

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

Link to This Section

Learn more about using slots.

Name Description
(default) Multiple <wa-progress-ring> elements to include in the group.

Attributes & Properties

Link to This Section

Learn more about attributes and properties.

Name Description Reflects
coloredLabels
colored-labels
Shows the extracted labels in their respective indicator color.
Type boolean
Default false
gap
gap
The gap between each ring in pixels when rendered in nested mode.
Type number
Default 2
mode
mode
The display mode.
Type 'nested' | 'stacked'
Default 'nested'
size
size
The diameter of the rings in pixels.
Type number
Default 128

CSS Parts

Link to This Section

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

Link to This Section

This component automatically imports the following elements. Sub-dependencies, if any exist, will also be included in this list.

  • <wa-progress-ring>
Need a hand? Report a bug Ask for help
Go Make Something Awesome
Version 0.5.1 © Fonticons, Inc.
  • Terms
  • Privacy
  • Refunds
  • Core License
  • Pro License

Quick Links

  • Components
  • CSS Utilities
  • Theming
  • Using with AI
  • Changelog
  • Help & Support

Recent Searches

    D'oh! No results for “”

    Suggest on GitHub Ask on Discord
    Navigate Select
    Close Esc