Slider
Slider(슬라이더) 위젯은 정해진 범위 안에서 값 하나를 드래그로 선택하는 입력 컨트롤입니다.
볼륨·밝기·비율처럼 연속적인 값을 조절할 때 사용합니다.
정의 / 역할
Slider 위젯은 가로 트랙 위의 손잡이(thumb)를 끌어 min~max 범위의 값을 선택합니다. divisions로 트랙을 균등 단계로 나눠 이산값만 고르게 할 수 있고, 트랙·눈금·손잡이 색과 트랙 두께를 지정할 수 있습니다.
- 카테고리: Contents
- 기본 범위:
min0.0 ~max1.0 - 기본 값:
0.0 - 기본 크기(SizedBox): 가로 100, 세로 50
- 슬라이더 종류:
material(기본) /adaptive
기능
| 기능 | 설명 |
|---|---|
| 값 선택 | 트랙 위 손잡이를 드래그해 min~max 사이의 값을 선택합니다. |
| 단계 나누기 | divisions로 트랙을 균등 단계로 나눠 이산값만 선택하게 합니다. 미지정 시 연속값입니다. |
| 슬라이더 종류 | material(기본)과 adaptive(플랫폼 적응형) 중에서 고릅니다. |
| 색·트랙 설정 | 활성·비활성 트랙, 눈금, 손잡이, 오버레이 색과 트랙 두께를 지정합니다. |
| 값 변경 이벤트 | onChanged로 드래그 중 값이 바뀔 때 실행할 동작을 연결합니다. |
사용 방법
- 왼쪽 위젯 팔레트에서 Contents 카테고리를 엽니다.
- Slider 항목을 캔버스로 끌어다 놓습니다.
- 오른쪽 속성 패널에서
min·max로 값 범위를 설정합니다. - 필요하면
divisions로 단계를 나누고, 트랙·손잡이 색과trackHeight를 조정합니다. onChanged에 값이 바뀔 때 실행할 동작(로직·스크립트)을 연결합니다.
속성 (Property)
| 속성 | 설명 | 기본값 | 값 / 타입 |
|---|---|---|---|
sliderType | 슬라이더 종류 | material | material, adaptive |
value | 현재 선택된 값 | 0.0 | 숫자 |
min | 선택 가능한 최소값 | 0.0 | 숫자 |
max | 선택 가능한 최대값 | 1.0 | 숫자 |
divisions | 트랙을 나눌 단계 수(이산값). 미지정 시 연속값 | 미지정 | 정수(1 이상) |
trackHeight | 트랙 두께 | 미지정 | 숫자 |
activeTrackColor | 손잡이 왼쪽(선택 구간) 트랙 색 | 미지정 | 색상 |
inactiveTrackColor | 손잡이 오른쪽(미선택 구간) 트랙 색 | 미지정 | 색상 |
activeTickMarkColor | 선택 구간 눈금 색 | 미지정 | 색상 |
inactiveTickMarkColor | 미선택 구간 눈금 색 | 미지정 | 색상 |
thumbColor | 손잡이 색 | 미지정 | 색상 |
overlayColor | 손잡이를 누를 때 나타나는 오버레이 색 | 미지정 | 색상 |
focusNode | 포커스 제어에 사용할 포커스 노드 | 미지정 | 포커스 노드 |
autofocus | 화면 표시 시 자동으로 포커스 | false | 참 / 거짓 |
주의 / 팁
팁
divisions를 지정하면 값이 연속이 아니라 균등 단계로 끊겨 선택됩니다. 미지정 시 min~max 사이 연속값을 자유롭게 고를 수 있습니다.
노트
activeTrackColor는 손잡이 왼쪽(선택된) 구간, inactiveTrackColor는 오른쪽(선택되지 않은) 구간에 적용됩니다.
더 알아보기
팁
이 위젯을 스크립트로 제어하는 Widget Control(Property·Method·Event) 전체는 Slider (슬라이더) Widget Control 문서에서 확인하세요.