Progress With Value

Overview

A progress bar that displays the current value.

This progress component is intended for interfaces that need a progress bar that displays the current value, upload flows, and onboarding steps. Its implementation is provided as editable source so the final behavior and styling stay inside your project.

Technologies

React
TypeScript
Tailwind CSS
shadcn/ui
Radix UI

Detected package dependencies: @radix-ui/react-progress.

@spectrumui/progress-with-value
()=>{}%

Installation

Login to view commandCreate a free account to access the install command

Usage

Value Position

@spectrumui/value-position
position: follow
()=>{}%
position: start
()=>{}%
position: end
()=>{}%
position: start-outside
()=>{}%
position: end-outside
()=>{}%

Custom Label

@spectrumui/custom-label
No Label
Custom label
current: %

Props

PropTypeRequiredDescription
position"start" | "start-outside" | "follow" | "end" | "end-outside"NoValue accepted by the position property in the exported source type.
label(value?: number | null) => React.ReactNodeNoValue accepted by the label property in the exported source type.
valueClassNamestringNoValue accepted by the valueClassName property in the exported source type.

Use cases

  • interfaces that need a progress bar that displays the current value
  • upload flows
  • onboarding steps

Features

  • Copy-paste source that remains in your repository
  • TypeScript source included with the component
  • Tailwind CSS classes editable in the component source
  • shadcn/ui dependencies: local UI primitives
  • Spectrum UI registry dependencies: @spectrumui/progress-with-value-dependencies

Accessibility

  • The source uses Radix UI primitives for the interactions detected on this component.
  • Test focus order, keyboard operation, labels, contrast, and screen-reader output in the final application context.

Customization

  • Edit the Tailwind utility classes in the copied source to match your spacing, color, and typography tokens.
  • Use the documented className surface for local layout adjustments, then edit the source for structural changes.

Related components

Animated Switch
An iOS-style toggle switch with a stretchy knob you can drag or flick.
Autosize Textarea
A textarea that automatically grows and shrinks to fit its content.
Button
A set of pre-designed buttons including gradient, outline, loading, and icon styles.
Datetime Picker
A date and time picker built on shadcn/ui with no extra dependencies.

Topic guides

See how this component fits into broader interface patterns, implementation decisions, and working examples.

React Component LibraryDashboard ComponentsPricing Sections

Progress With Value FAQ

Is Progress With Value free to use in commercial projects?

Yes. The public Progress With Value source is available under the Apache License 2.0, including for commercial use, subject to the LICENSE terms.

How do I install Progress With Value?

Run npx shadcn@latest add @spectrumui/progress-with-value or npx shadcn@latest add @spectrumui/value-position or npx shadcn@latest add @spectrumui/custom-label. The page also exposes the source for manual installation.

Does Progress With Value require Motion?

No Motion dependency was detected in the documented source or registry entry for Progress With Value.

Does Progress With Value use shadcn/ui or Radix UI?

Progress With Value uses local shadcn/ui primitives and imports Radix UI directly.

Can I use Progress With Value in Next.js?

The documented React source is used in this Next.js application. Keep its use client directive when copying it into the App Router. Install the detected dependencies and verify any application-specific data or image configuration.

What accessibility checks should I run for Progress With Value?

The source includes Radix UI primitives. Test the finished interface with keyboard and screen-reader workflows.