Elastic Slider

Slider with elastic rubber-band drag and magnetic snap feedback.

Last updated January 1, 1980

CreditsModifiedPublished

Copied from Josh Puckett — Interface Craft and Chánh Đại — Elastic Slider.

Value 0 now maps to the reading start (right edge in RTL) instead of always the physical left, matching a native <input type="range"> in RTL browsers
Arrow key direction follows reading direction: ArrowRight decreases the value in RTL instead of always increasing it
Fill, handle, hash marks, label, and value text use logical start/end positioning instead of left/right

Overview

Installation

$ pnpm dlx shadcn@latest add @persianlabsui/elastic-slider

Usage

import { ElasticSlider } from "@/components/elastic-slider"
 
const [opacity, setOpacity] = useState(0.5)
 
<ElasticSlider
  label="Opacity"
  min={0}
  max={1}
  value={opacity}
  onValueChange={setOpacity}
/>

Uncontrolled:

<ElasticSlider label="Opacity" min={0} max={1} defaultValue={0.5} />

Range slider

Need two handles on one track — a min and a max, like a price filter? Use Elastic Range Slider instead.

Examples

RTL

Keyboard

Keys

Prop	Type	Default	Description
ArrowRight / ArrowUp	—	—	Increase by one step. ArrowRight decreases instead in RTL.
ArrowLeft / ArrowDown	—	—	Decrease by one step. ArrowLeft increases instead in RTL.
Shift + Arrow	—	—	Increase or decrease by step × 10.
Home	—	—	Jump to min.
End	—	—	Jump to max.

API Reference

ElasticSlider

Prop	Type	Default	Description
label	string	required	Label shown inside the track.
value	number	undefined	Controlled value. Use together with onValueChange.
defaultValue	number	min	Initial value for uncontrolled mode.
onValueChange	(value: number) => void	—	Called with the new value on drag, click, or key press.
min	number	0	Minimum value.
max	number	1	Maximum value.
step	number	0.01	Smallest increment.
formatValue	(value: number) => string	value.toFixed(...)	Format the displayed value, based on step's decimal precision by default.
aria-label	string	label	Accessible name. Falls back to label.

Edit this page on GitHub

PreviousElastic Range Slider NextEmpty