Skip to content

shadcn.io is an independent project built on shadcn/ui

Free

Slider with Value Display for React

A Quality slider at 65% with the percentage beside the label, on the same row, as the thumb moves.

Quality is on the left and 65% is on the right, above a single track. The percentage is the only readout.

Use it when the exact number matters as much as where the thumb sits. A Number Input helps if people need one specific value. In React, Base UI does not format the percent.

Preview

Preview width

Installation

Sign in to get your install command
Free with an account. It carries your token, so the CLI installs everything in one go.
Use email insteadNo credit card

Anatomy

Slider anatomy: root, label, value, track, range, thumb

Usage

<div className="flex w-full max-w-md flex-col gap-2">
  <div className="flex items-center justify-between">
    <Label>Quality</Label>
    <span className="text-muted-foreground text-sm tabular-nums">
      {value[0]}%
    </span>
  </div>
  <Slider
    aria-label="Quality"
    onValueChange={handleValueChange}
    value={value}
  />
</div>

FAQ

How does the readout follow the thumb?

The value lives in state, starting at 65, and goes back to the slider as value. The percentage beside the label prints the first value with a % sign. onValueChange receives the new value, and the handler stores it as an array.

How are the label and number placed?

In a flex items-center justify-between row above the slider. The number is muted and uses tabular-nums, so it keeps its width as digits change.

How is the slider named?

The Quality text is a visible Label, and the slider gets the same name with aria-label, so screen readers announce what it sets. On Base UI, aria-label is one string on the slider.

What scale is the percentage on?

0 to 100 in steps of 1, so the value is already a percentage. min and max set the ends.

Can I move it from the keyboard?

Yes. The thumb takes focus with Tab. The arrow keys move it by one step, Page Up and Page Down by a larger step, and Home and End jump to the ends.

When should I save the quality?

The change callback runs on every step while the thumb moves. Save or fetch from the end-of-change callback, which runs once when dragging stops. On Base UI it is onValueCommitted.

API Reference

Label

No extra props in this demo. The rest is on the Label page.

Slider

Sets aria-label="Quality", onValueChange={handleValueChange} and value={value}. The rest is on the Slider page.