Switch 구성요소를 사용하면 사용자가 선택됨과 선택되지 않음이라는 두 상태 간에 전환할 수 있습니다. 스위치를 사용하여 사용자가 다음 중 하나를 실행할 수 있도록 합니다.
- 설정을 사용 설정 또는 사용 중지합니다.
- 기능을 사용 설정 또는 사용 중지합니다.
- 옵션을 선택합니다.
이 구성요소는 엄지손가락과 트랙의 두 부분으로 구성됩니다. 썸은 스위치의 드래그 가능한 부분이고 트랙은 배경입니다. 사용자는 스위치의 상태를 변경하기 위해 엄지손가락을 왼쪽이나 오른쪽으로 드래그할 수 있습니다. 스위치를 탭하여 확인하고 지울 수도 있습니다.
버전 호환성
이 구현에서는 프로젝트 minSDK가 API 수준 21 이상으로 설정되어야 합니다.
종속 항목
스위치 구현
다음 예는 Switch 컴포저블의 최소 구현입니다.
결과
맞춤 썸 만들기
thumbContent 매개변수에 컴포저블을 전달하여 맞춤 썸을 만들 수 있습니다. 다음은 엄지에 맞춤 아이콘을 사용하는 스위치의 예입니다.
결과
선택되지 않은 모양은 이전 섹션의 예와 동일합니다. 하지만 선택하면 이 구현은 다음과 같이 표시됩니다.
맞춤 색상 사용
colors 매개변수를 사용하여 스위치의 썸과 트랙의 색상을 변경합니다. 스위치가 선택되어 있는지 여부가 고려됩니다.
결과
핵심사항
기본 매개변수:
checked: 스위치의 초기 상태입니다.onCheckedChange: 스위치 상태가 변경될 때 호출되는 콜백입니다.enabled: 스위치가 사용 설정 또는 중지되었는지 여부입니다.colors: 스위치에 사용되는 색상입니다.
고급 매개변수
thumbContent: 선택된 경우 엄지의 모양을 맞춤설정하는 데 사용합니다.colors: 트랙과 썸의 색상을 맞춤설정하는 데 사용합니다.
이 가이드가 포함된 컬렉션
이 가이드는 더 광범위한 Android 개발 목표를 다루는 선별된 빠른 가이드 모음의 일부입니다.
상호작용 구성요소 표시
컴포저블 함수를 사용하면 Material Design 디자인 시스템을 기반으로 아름다운 UI 구성요소를 쉽게 만들 수 있습니다.
질문이나 의견이 있는 경우
자주 묻는 질문(FAQ) 페이지에서 빠른 가이드를 확인하거나 의견을 보내주세요.