컴포넌트로 돌아가기05070
단일 값 또는 범위 모드를 지원하는 숫자 값 선택용 슬라이더 컴포넌트입니다.
설치
Import
@hua-labs/ui의 UI 컴포넌트를 @hua-labs/hua에서 통합 제공합니다.
UI 컴포넌트, 모션 훅, i18n을 하나의 패키지로 사용할 수 있습니다.
라이브 데모
기본 슬라이더
값 표시
레이블 포함
범위 슬라이더
가격 범위:
$20 - $80
변형
default
primary
success
warning
danger
크기
sm
md
lg
세로 방향
sm
md
lg
상태
Normal
Disabled
Props
| 이름 | 타입 | 기본값 | 설명 |
|---|---|---|---|
variant | "default" | "primary" | "success" | "warning" | "danger" | "default" | 시각적 스타일 변형 |
size | "sm" | "md" | "lg" | "md" | 슬라이더 크기 |
value | number | number[] | 0 | 현재 값 (배열이면 범위 슬라이더) |
onValueChange | (value: number | number[]) => void | - | Callback when value changes |
min | number | 0 | 최소값 |
max | number | 100 | 최대값 |
step | number | 1 | 단계 증가량 |
showValue | boolean | false | Display current value |
showLabel | boolean | false | Display label |
label | string | - | 슬라이더 레이블 |
orientation | "horizontal" | "vertical" | "horizontal" | 슬라이더 방향 |
disabled | boolean | false | 슬라이더 비활성화 |
dot | string | - | |
style | React.CSSProperties | - |
코드 예시
접근성
- •슬라이더 역할: 올바른 시맨틱을 위한 role='slider' 사용
- •키보드 탐색: 화살표 키로 값 조절, Home/End로 최소/최대 이동
- •aria-valuetext: 스크린 리더에 현재 값을 전달
- •포커스 표시: 키보드 사용자를 위한 포커스 표시