NV Elements Catalog Starters Repo System Themes Getting Started Getting Started Installation CLI MCP Skills Lint Integrations Getting Started Angular Bundles Custom Elements Golang Hugo Import Maps Lit Lit Library MCP Apps NextJS Nuxt Preact React SolidJS Svelte TypeScript Vue About Changelog Metrics Support Accessibility Contributions Requests Migration Foundations Overview Typography Iconography Themes Design Tokens Size & Space Objects Interactions Support Status Color Animation Fonts Layers Custom Layout Horizontal Vertical Grid Popovers i18n Visualization View Transitions Elements Accordion Alert Avatar Badge Breadcrumb Button Button Group Card Chat Message Checkbox Color Combobox Copy Button Datagrid Integrations Column Action Column Alignment Column Fixed Column width Container Card Display Settings Footer Heatmap Keynav Multi Select Pagination Panel Detail Panel Grid Performance Placeholder Row Action Row Groups Row Sort Scroll Height Single Select Stripe Date Datetime Dialog Divider Dot Drawer Dropdown Dropdown Group Dropzone File Format Datetime Format Number Format Relative Time Forms Validation Actions Control Icon Icon Button Input Input Group Logo Menu Month Notification Page Page Header Page Loader Pagination Progressive Filter Chip Progress Bar Progress Ring Password Preferences Input Pulse Radio Range Resize Handle Search Select Skeleton Sort Button Sparkline Star Rating Steps Switch Tabs Tag Textarea Time Toast Toggletip Toolbar Tooltip Tree Week Patterns Authentication Browse Chat Dashboard Editor Empty States Heatmap Keyboard Shortcut Logging Media Navigation Onboarding Panel Responsive Search Subheader Trend Code Codeblock Monaco Input Diff Input Editor Diff Editor Problems Markdown Markdown CSS Utility Labs Responsive Layout Viewport Container Patterns Forms API Design Properties & Attributes Slots Registration CustomEvents Stateless Composition Styles Packaging Glossary Logs Internal Guidelines Agent Harness Agent Tooling Agent Ownership Documentation Examples TypeScript Testing Unit Testing Accessibility Testing Lighthouse Testing SSR Testing Visual Testing Troubleshooting Component Creation Internal Examples All Examples

Progress Ring

stable:  0.2.3 Coverage: 100.00% Bundle: 15.31kb Lighthouse: 100 Axe Core Released: 0.17.0
Overview API Examples
DefaultValuesMaxStatusWithTextSlottedIconSizingWithButton

Default

Edit Example

The progress-ring component shows the status of a pending task. It also serves the basis of the page loading element.

Values

test-case
Edit Example

Progress rings displaying completion percentages from indeterminate to 0%, 33%, 66%, and 100%.

Max

test-case
Edit Example

The max value of the progress ring that the value is proportionally scaled to.

Max Description number

Status

Edit Example

Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions.

Status Description accent Highlights important actions or draws attention to primary interactive elements. warning Indicates cautionary actions that require careful consideration before proceeding. success Represents positive outcomes, confirmations, or constructive actions. danger Signals destructive or irreversible actions that need extra attention and confirmation. neutral

With Text

Processing...
Edit Example

Progress ring paired inline with descriptive text label for communicating loading state.

Slotted Icon

test-case
Edit Example

Progress ring with custom status icon slotted in the center for enhanced visual communication.

Sizing

test-case
Edit Example

Progress rings in many sizes from extra-extra-small to extra-large for different UI contexts.

With Button

Button Button Button Button Button Button
Edit Example

Progress rings integrated within buttons to show loading states during actions and operations.