Progress Ring

<wa-progress-ring> Stable Since 2.0

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

Link to This Section

Size

Link to This Section

Use the --size custom property to set the diameter of the progress ring.

Track and Indicator Width

Link to This Section

Use the --track-width and --indicator-width custom properties to set the width of the progress ring's track and indicator.

Colors

Link to This Section

To change the color, use the --track-color and --indicator-color custom properties.

Labels

Link to This Section

Use the default slot to show a label inside the progress ring.

50%

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://ka-f.webawesome.com/[email protected]/components/progress-ring/progress-ring.js';

After installing Web Awesome via npm, import this component:

import '@awesome.me/webawesome/dist/components/progress-ring/progress-ring.js';

If you're self-hosting Web Awesome, import this component from your server:

import './webawesome/dist/components/progress-ring/progress-ring.js';

To import this component for React 18 or below, use the following code:

import WaProgressRing from '@awesome.me/webawesome/dist/react/progress-ring/index.js';

Slots

Link to This Section

Learn more about using slots.

Attributes & Properties

Link to This Section

Learn more about attributes and properties.

CSS custom properties

Link to This Section

Learn more about CSS custom properties.

CSS parts

Link to This Section

Learn more about CSS parts.

Need a hand? Report a bug Ask for help
    No results