NV NVIDIA Elements Catalog Starters GitHub System Themes

Progress Ring

stable:  2.15.4 Coverage: 94.44% Bundle: 15.28kb Lighthouse: 100 Axe Core Released: 0.17.0
Overview API Examples

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

Installation

CLI / MCP / CDN

Value

The current value of the progress ring. When not set, an indeterminate animation will show.

Value Description number

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

Max Value

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

Max Description number

Progress rings with custom max values for proportional progress within a defined scale.

Indicating Status

Four visual treatments represent the status of tasks. When status changes to warning, success, or danger, the component embeds appropriate icons.

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

Progress rings with warning and danger status colors for indicating critical or cautionary states.

When used with text, please set size="xs".

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

Processing...

Sizing

T-shirt size of the progress indicator, used to scale the ring.

Size Description sm Compact size for dense layouts or secondary elements with less visual prominence. md Standard size that works well in most contexts and provides balanced visibility. lg Larger size for emphasizing important elements or improving touch targets in spacious layouts. xxs xs xl

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

Custom Icon Slotting

Use the default slot within nve-progress-ring to create a custom loading indicator.

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

Using within a Button

When using nve-progress-ring within a nve-button, set the status to neutral to properly inherit button background color.

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

Button Button Button Button Button Button

Release Status

All elements and features go through 3 phases of stability, pre-release, beta and stable.

pre-release
Docs Preview API Documentation Fully Themeable
beta
Robust unit test coverages Passed API Review Passed Designer VQA Review Included in library package
stable
No known outstanding AA WCAG issues No known outstanding performance issues Adapts to different screen/container sizes No breaking API changes for at least 90 days
Getting Started Getting Started Installation CLI MCP Skills Lint GitHub Integrations Getting Started Angular Bundles CDN Custom Elements Eleventy Golang HTMX + Go Hugo Import Maps Lit Lit Library MCP Apps NextJS Nuxt Pi Preact React SolidJS Sphinx Svelte TypeScript Vue About What’s New Changelog Metrics Support Accessibility Contributions Requests Migration Sitemap 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 DESIGN.md Elements Accordion Alert Avatar Badge Breadcrumb Button Button Group Card Chat Message Checkbox Codeblock Color Combobox Copy Button Datagrid Getting Started 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 Drag Handle Drawer Dropdown Dropdown Group Dropzone File Format Bytes Datetime Number Relative Time Truncate Forms Getting Started Validation Actions Control Gauge Icon Icon Button Input Input Group Logo Markdown Markdown CSS Media Controller Pause Button Playback Rate Select Loop Button Mute Button Media PiP Button Seek Button Time Range Volume Range Full-screen Button Menu Month Monaco Input Diff Input Monaco Editor Diff Editor Problems 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 Viewport Viewport Gridlines Minimap Zoom Range Week Patterns Agent Authentication Browse Chat Code Dashboard Editor Empty States Heatmap Keyboard Shortcut Logging Media Navigation Onboarding Panel Responsive Search Subheader Trend 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