Switch
Switch(스위치) 위젯은 켜짐/꺼짐 두 상태를 오가는 슬라이더형 토글 스위치입니다.
설정 on/off처럼 두 상태 중 하나를 선택받을 때 사용합니다.
정의 / 역할
Switch 위젯은 트랙 위의 손잡이(thumb)를 좌우로 옮겨 켜짐·꺼짐 상태를 전환하는 컨트롤입니다. 누르면 상태가 토글되며 onChanged 동작이 실행됩니다. 상태·활성 여부·크기·모서리·손잡이 크기와 상태별(켜짐/꺼짐/비활성) 트랙·손잡이 색을 설정할 수 있습니다.
- 카테고리: Contents
- 기본 크기:
38 × 22(손잡이(thumbSize)14, 모서리(radius)10)
기능
| 기능 | 설명 |
|---|---|
| 상태 전환 | 탭하면 켜짐/꺼짐이 토글되고 onChanged가 실행됩니다. |
| 활성/비활성 | enable로 사용 가능 여부를 정하며, 비활성일 때는 전용 색으로 그려집니다. |
| 크기·모양 | 크기(너비·높이)·모서리 둥글기(radius)·손잡이 크기(thumbSize)를 조정합니다. |
| 상태별 색 | 켜짐·꺼짐·비활성(켜짐/꺼짐) 각 상태의 트랙·손잡이 색을 따로 설정합니다. |
사용 방법
- 왼쪽 위젯 팔레트에서 Contents 카테고리를 엽니다.
- Switch 항목을 캔버스로 끌어다 놓습니다.
- 오른쪽 속성 패널에서 초기 상태(
value)와 색을 원하는 값으로 조정합니다. onChanged에 상태가 바뀔 때 실행할 동작(로직·스크립트)을 연결합니다.
속성 (Property)
| 속성 | 설명 | 기본값 | 값 / 타입 |
|---|---|---|---|
value | 스위치 켜짐/꺼짐 상태 | 꺼짐(false) | 참 / 거짓 |
enable | 사용 가능(활성) 여부 | 켜짐(true) | 참 / 거짓 |
Size | 스위치 크기 — 너비(width)·높이(height)를 함께 지정하는 묶음 속성 | 너비 38·높이 22 | 크기(너비·높이, 숫자 px) |
thumbSize | 손잡이(thumb) 크기 | 14 | 숫자(px, 최소 14) |
radius | 트랙 모서리 둥글기 | 10 | 숫자(px) |
activeTrackColor | 켜짐 상태 트랙 색 | #9483FF (보라) | 색상 |
activeThumbColor | 켜짐 상태 손잡이 색 | #FFFFFF (흰색) | 색상 |
inactiveTrackColor | 꺼짐 상태 트랙 색 | #94999F (회색) | 색상 |
inactiveThumbColor | 꺼짐 상태 손잡이 색 | #FFFFFF (흰색) | 색상 |
disabledTrackColor | 비활성(꺼짐) 트랙 색 | #9F9F9F | 색상 |
disabledThumbColor | 비활성(꺼짐) 손잡이 색 | #737373 | 색상 |
disabledActiveTrackColor | 비활성(켜짐) 트랙 색 | #9F9F9F | 색상 |
disabledActiveThumbColor | 비활성(켜짐) 손잡이 색 | #6750A4 | 색상 |
주의 / 팁
팁
켜짐·꺼짐 색은 activeTrackColor·inactiveTrackColor로, 비활성 상태 색은 disabled... 계열로 따로 지정합니다.
팁
thumbSize(손잡이 크기)는 최소 14입니다. 손잡이가 트랙 높이(height)에 맞게 보이도록 크기를 함께 조정하세요.
더 알아보기
팁
이 위젯을 스크립트로 제어하는 Widget Control(Property·Method·Event) 전체는 Switch (스위치) Widget Control 문서에서 확인하세요.