Skip to content
Docs
컴포넌트로 돌아가기

Slider

@hua-labs/hua
v1.1.0

단일 값 또는 범위 모드를 지원하는 숫자 값 선택용 슬라이더 컴포넌트입니다.

설치

bash
npm install @hua-labs/hua
Import
tsx
import { Slider } from "@hua-labs/hua";

@hua-labs/ui의 UI 컴포넌트를 @hua-labs/hua에서 통합 제공합니다.

UI 컴포넌트, 모션 훅, i18n을 하나의 패키지로 사용할 수 있습니다.

라이브 데모

기본 슬라이더

값 표시

0

레이블 포함

50
70

범위 슬라이더

가격 범위:
$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"슬라이더 크기
valuenumber | number[]0현재 값 (배열이면 범위 슬라이더)
onValueChange(value: number | number[]) => void-Callback when value changes
minnumber0최소값
maxnumber100최대값
stepnumber1단계 증가량
showValuebooleanfalseDisplay current value
showLabelbooleanfalseDisplay label
labelstring-슬라이더 레이블
orientation"horizontal" | "vertical""horizontal"슬라이더 방향
disabledbooleanfalse슬라이더 비활성화
dotstring-
styleReact.CSSProperties-

코드 예시

기본 사용법
import { Slider } from '@hua-labs/ui/form';

<Slider />
제어 모드
const [value, setValue] = useState(50);

<Slider
  value={value}
  onValueChange={setValue}
  showValue
  label="Volume"
  showLabel
/>
범위 슬라이더
const [range, setRange] = useState([20, 80]);

<Slider
  value={range}
  onValueChange={setRange}
  showValue
  label="Price Range"
  showLabel
/>

접근성

  • 슬라이더 역할: 올바른 시맨틱을 위한 role='slider' 사용
  • 키보드 탐색: 화살표 키로 값 조절, Home/End로 최소/최대 이동
  • aria-valuetext: 스크린 리더에 현재 값을 전달
  • 포커스 표시: 키보드 사용자를 위한 포커스 표시