Switch
구성요소를 사용하면 사용자가 선택됨과 선택 해제됨이라는 두 상태 간에 전환할 수 있습니다. 스위치를 사용하여 사용자가 다음 중 하나를 할 수 있도록 합니다.
- 설정을 사용 또는 사용 중지합니다.
- 기능을 사용 설정 또는 사용 중지합니다.
- 옵션을 선택합니다.
이 구성요소는 썸과 트랙이라는 두 부분으로 구성됩니다. 썸은 스위치의 드래그 가능한 부분이고 트랙은 배경입니다. 사용자는 엄지손가락을 왼쪽이나 오른쪽으로 드래그하여 스위치의 상태를 변경할 수 있습니다. 스위치를 탭하여 선택 및 선택 해제할 수도 있습니다.
버전 호환성
이 구현을 사용하려면 프로젝트 minSDK를 API 수준 21 이상으로 설정해야 합니다.
종속 항목
스위치 구현
다음 예는 Switch
컴포저블의 최소 구현입니다.
결과
![선택 해제된 기본 스위치](https://developer.android.com/static/develop/ui/compose/images/components/switch-deactivated.png?hl=ko)
![선택된 기본 스위치](https://developer.android.com/static/develop/ui/compose/images/components/switch.png?hl=ko)
맞춤 썸네일 만들기
thumbContent
매개변수에 컴포저블을 전달하여 맞춤 썸네일을 만들 수 있습니다. 다음은 썸네일에 맞춤 아이콘을 사용하는 스위치의 예입니다.
결과
선택 해제된 모양은 이전 섹션의 예와 같습니다. 하지만 선택하면 이 구현은 다음과 같이 표시됩니다.
![thumbContent 매개변수를 사용하여 선택 시 맞춤 아이콘을 표시하는 스위치입니다.](https://developer.android.com/static/develop/ui/compose/images/components/switch-icon.png?hl=ko)
맞춤 색상 사용
colors
매개변수를 사용하여 스위치가 선택되었는지 여부를 고려하여 스위치의 썸과 트랙의 색상을 변경합니다.
결과
![colors 매개변수를 사용하여 슬라이더와 탭 모두에 맞춤 색상으로 스위치를 표시하는 스위치입니다.](https://developer.android.com/static/develop/ui/compose/images/components/switch-colors.png?hl=ko)
핵심사항
기본 매개변수:
checked
: 스위치의 초기 상태입니다.onCheckedChange
: 스위치의 상태가 변경될 때 호출되는 콜백입니다.enabled
: 스위치가 사용 설정 또는 중지되었는지 여부입니다.colors
: 스위치에 사용되는 색상입니다.
고급 매개변수
thumbContent
: 선택되었을 때 썸네일의 모양을 맞춤설정하는 데 사용합니다.colors
: 트랙과 썸네일의 색상을 맞춤설정하는 데 사용합니다.
이 가이드가 포함된 컬렉션
이 가이드는 더 광범위한 Android 개발 목표를 다루는 선별된 빠른 가이드 모음의 일부입니다.
![](https://developer.android.com/static/images/quick-guides/collection-illustration.png?hl=ko)
대화형 구성요소 표시
구성 가능한 함수를 사용하여 Material Design 디자인 시스템을 기반으로 멋진 UI 구성요소를 쉽게 만드는 방법을 알아보세요.
질문이나 의견이 있으신가요?
자주 묻는 질문(FAQ) 페이지로 이동하여 빠른 가이드를 알아보거나 문의하여 의견을 보내주세요.