# Slider

An input where the user selects a value from within a given range.

## Installation

```bash
npx shadcn@latest add https://reactdocs.canceydejean.dev/r/slider.json
```

[Registry JSON](https://reactdocs.canceydejean.dev/r/slider.json)

## Preview

```tsx
import { Slider } from "@/components/ui/slider/slider";

export function Preview() {
  return (
    <div className="w-full max-w-sm px-1">
      <Slider defaultValue={[50]} max={100} step={1} aria-label="Volume" />
    </div>
  );
}
```


## Source

### slider.tsx

```tsx
import { Slider as SliderPrimitive } from "@base-ui/react/slider";

import { cn } from "cn";

function Slider({
  className,
  defaultValue,
  value,
  min = 0,
  max = 100,
  ...props
}: SliderPrimitive.Root.Props) {
  const values = Array.isArray(value)
    ? value
    : Array.isArray(defaultValue)
      ? defaultValue
      : [min, max];

  return (
    <SliderPrimitive.Root
      className={cn("data-horizontal:w-full data-vertical:h-full", className)}
      data-slot="slider"
      defaultValue={defaultValue}
      value={value}
      min={min}
      max={max}
      thumbAlignment="edge"
      {...props}
    >
      <SliderPrimitive.Control className="relative flex w-full touch-none items-center select-none data-disabled:opacity-50 data-vertical:h-full data-vertical:min-h-40 data-vertical:w-auto data-vertical:flex-col">
        <SliderPrimitive.Track
          data-slot="slider-track"
          className="bg-muted relative grow overflow-hidden rounded-full select-none data-horizontal:h-1 data-horizontal:w-full data-vertical:h-full data-vertical:w-1"
        >
          <SliderPrimitive.Indicator
            data-slot="slider-range"
            className="bg-primary select-none data-horizontal:h-full data-vertical:w-full"
          />
        </SliderPrimitive.Track>
        {values.map((thumbValue) => (
          <SliderPrimitive.Thumb
            data-slot="slider-thumb"
            key={String(thumbValue)}
            className="border-ring ring-ring/50 relative block size-3 shrink-0 rounded-full border bg-white transition-[color,box-shadow] select-none after:absolute after:-inset-2 hover:ring-3 focus-visible:ring-3 focus-visible:outline-hidden active:ring-3 disabled:pointer-events-none disabled:opacity-50"
          />
        ))}
      </SliderPrimitive.Control>
    </SliderPrimitive.Root>
  );
}

export { Slider };
```



## Usage

Use for volume, price ranges, and other continuous values. Pass a single value or a range via
arrays.

```tsx
import { Slider } from "@/components/slider/slider";

export function Example() {
  return <Slider defaultValue={[50]} max={100} step={1} />;
}
```

For a range, use two values: `defaultValue={[25, 75]}`. Control with `value` and `onValueChange`.