Slider
Base UI Slider 기반으로 단일 값과 number[] range API를 제공합니다. 배열 항목 수만큼 thumb를 만들고 thumbLabels로 각 input의 이름을 지정하며, 가로·세로 방향과 controlled·uncontrolled 값을 지원합니다.
@neumorphism-ui/slider미리보기
가격 범위₩32K – ₩72K
설치
설치: slider
npx shadcn@latest add @neumorphism-ui/sliderCLI가 npm 의존성, base 토큰, utils와 컴포넌트 소스를 순서대로 확인하고 설치합니다.
Registry를 처음 사용한다면 namespace 설정 을 먼저 완료하세요.
사용법
사용법: 설치
npx shadcn@latest add @neumorphism-ui/slider @neumorphism-ui/labelImport
Slider import 코드
import { Slider } from "@/components/ui/slider"
import { Label } from "@/components/ui/label"Example
Slider 사용 코드
<div className="grid gap-3">
<div className="flex justify-between">
<Label id="depth-label">Depth intensity</Label>
<output>64%</output>
</div>
<Slider
defaultValue={[64]}
min={0}
max={100}
step={1}
aria-labelledby="depth-label"
thumbLabels={["Depth intensity"]}
/>
</div>API 레퍼런스
| 컴포넌트 | 속성 | 타입 | 기본값 | 설명 |
|---|---|---|---|---|
Slider | value / defaultValue | number[] | [min] | thumb별 controlled 또는 초기 uncontrolled 값입니다. |
Slider | min / max | number | 0 / 100 | 선택 가능한 숫자 범위입니다. |
Slider | step | number | 1 | 키보드와 포인터 조정 단위입니다. |
Slider | orientation | "horizontal" | "vertical" | "horizontal" | track 방향과 키보드 축을 설정합니다. |
Slider | thumbLabels | readonly string[] | — | 값 순서대로 실제 thumb input에 전달할 접근 가능한 이름입니다. |
Slider | onValueChange / onValueCommitted | (value: number | number[]) => void | — | 조정 중 또는 조정이 끝났을 때 배열 값을 전달합니다. |
Slider | disabled | boolean | false | 모든 thumb의 상호작용을 비활성화합니다. |
접근성
- 01
Slider root는 aria-label 또는 aria-labelledby로 그룹의 이름을 제공하고, thumbLabels에는 각 조절점의 이름을 값 순서대로 제공합니다.
- 02
Base UI가 각 thumb의 role=slider, 현재 값, 최소·최대 값과 Arrow/Page/Home/End 키 동작을 관리합니다.
- 03
단일 값은 한 개, 범위 값은 최소·최대처럼 서로 구분되는 이름을 thumbLabels에 전달합니다.