Slider
Freev1.0.0The shadcn Slider with value tags, ticks and marks.
Build for your project
Code/install build
Usage
Import it and pass your content. The props that matter most are listed next.
Example
"use client";
import * as React from "react";
import { Slider } from "@/components/ui/notchset/slider";
const usd = (v: number) => `$${v.toLocaleString("en-US")}`;
export function BudgetBand() {
const [band, setBand] = React.useState([2000, 7500]);
return <Slider value={band} onValueChange={setBand} max={10000} step={250} tagFormatter={usd} thumbLabels={["Min", "Max"]} />;
}Props
value / onValueChange–number[]One value or two (a range).
min / max / step–numberThe scale.
minStepsBetweenValues–numberThe narrowest range.
tagFormatter–(v) => stringThe tag's text (Base UI's own `format` takes Intl options, as in shadcn).
orientation–"horizontal" | "vertical"As shadcn's; ticks and marks draw on horizontal sliders only.
thumbLabels–string[]Each thumb's aria-label.
Show all 8 propsShow fewer
ticks–{ every, major? }Ticks under the rail.
marks–{ value, label }[]Labels under it.
Anatomy
- Same API as shadcn's Slider (value as an array).
- Base UI and Radix builds: your components.json picks one.
- Ticks and marks ink themselves inside the fill.
Sliderdata-slot="slider"The root.
—data-slot="slider-range"The fill.
—data-slot="slider-thumb"A thumb.
Source
components/ui/notchset/slider.tsx
Loading the code
Build for your project
Code/install build
Installation
Base UI
pnpm dlx shadcn@latest add https://notchset.dev/r/slider.jsonRadix
pnpm dlx shadcn@latest add https://notchset.dev/r/radix-nova/slider.jsonFree, no account or key. Use the command for your project's primitives: a radix-*, new-york or default style in components.json is Radix, a base-* style is Base UI. With the @notchset registry added, @notchset/<name> picks for you.
Install by hand
- 1. Add the packages
pnpm add @base-ui/react@^1 - 2. Copy the files to these paths (the source, or save them all as a .zip)
- components/ui/notchset/slider.tsx
- lib/beautiful-ui/notchset/slider.tsx
- lib/beautiful-ui/notchset/instrument.tsx
- lib/beautiful-ui/notchset/root.ts
- 3. No stylesheet needed.
- 4. Install what it builds on first: shadcn's cn helper (lib/utils.ts, from npx shadcn init), the theme foundation (its tokens and base styles)
Styles didn't apply?
The CLI adds the styles to the CSS file named in components.json (tailwind.css). Check that it points at your global stylesheet, that the project uses Tailwind CSS v4, and that the file is imported in your root layout. Installed by hand: paste styles.css into that file.
For coding agents
Give your coding assistant the Markdown guide instead of screenshots.
Use it for
- A value or a band on a known scale, where seeing it matters more than typing it
Use something else when
- Exact numbers: use Number Field
Mistakes to avoid
- Label each thumb of a range
- It is horizontal only: the orientation prop is not accepted. For a vertical control, use a Number Field or a stepper
Agents find it by
- slider, range slider, price range, temperature, volume, shadcn slider, Notchset
Where agents read it
- Guide for this component: https://notchset.dev/md/slider.md
- Every component, for tools without MCP: /llms.txt
- MCP server:
https://notchset.dev/api/mcp(setup)
Behaviour
Keyboard
- ← → ↑ ↓
- Step
- PgUp / PgDn
- 4 steps (Base UI) or 10% (Radix)
- Home / End
- Min / max
Accessibility
- The Base UI or Radix slider: each thumb is a slider with its own label and value text
- RTL and form values from the primitive
Motion
- Click
- The thumb and fill glide (280ms settle)
- Drag
- The thumb squashes to 86% and follows exactly
- Tag
- Fades in (140ms) and rises 4px (260ms) on hover, focus or drag
Responsive
- Fills its container.
Performance
- CSS transitions; no measuring.
Changelog
v1.0.0 · 2026-10-02
First release
