사용자가 전환할 수 있는 스위치 추가

Switch 구성요소를 사용하면 사용자가 선택됨 과 선택되지 않음의 두 상태 간에 전환할 수 있습니다. 스위치를 사용하여 사용자가 다음 중 하나를 실행하도록 합니다.

  • 설정을 사용 또는 사용 중지합니다.
  • 기능을 사용 설정 또는 사용 중지합니다.
  • 옵션을 선택합니다.

구성요소에는 엄지와 트랙의 두 부분이 있습니다. 엄지는 스위치의 드래그 가능한 부분이고 트랙은 배경입니다. 사용자는 엄지를 왼쪽이나 오른쪽으로 드래그하여 스위치의 상태를 변경할 수 있습니다. 또한 스위치를 탭하여 선택하고 선택 해제할 수 있습니다.

버전 호환성

이 구현에서는 프로젝트 minSDK를 API 수준 21 이상으로 설정해야 합니다.

종속 항목

스위치 구현

다음 예는 Switch 컴포저블의 최소 구현입니다.

결과

선택되지 않은 기본 스위치
그림 1. 선택되지 않은 스위치
선택된 기본 스위치
그림 2. 선택된 스위치

맞춤 엄지 만들기

thumbContent 매개변수에 컴포저블을 전달하여 맞춤 엄지를 만들 수 있습니다. 다음은 엄지에 맞춤 아이콘을 사용하는 스위치의 예입니다.

결과

선택되지 않은 모양은 이전 섹션의 예와 동일합니다. 하지만 선택된 경우 이 구현은 다음과 같이 표시됩니다.

선택 시 thumbContent 매개변수를 사용하여 맞춤 아이콘을 표시하는 스위치
그림 3. 맞춤 선택 아이콘이 있는 스위치

사용자 지정 색상 사용

colors 매개변수를 사용하여 스위치의 선택 여부를 고려하여 스위치의 엄지와 트랙 색상을 변경합니다.

결과

색상 매개변수를 사용하여 썸과 택 모두에 사용자 지정 색상이 있는 스위치를 표시하는 스위치
그림 4. 사용자 지정 색상이 있는 스위치

핵심 사항

  • 기본 매개변수:

    • checked: 스위치의 초기 상태입니다.
    • onCheckedChange: 스위치의 상태가 변경될 때 호출되는 콜백입니다.
    • enabled: 스위치가 사용 설정 또는 사용 중지되었는지 여부입니다.
    • colors: 스위치에 사용되는 색상입니다.
  • 고급 매개변수

    • thumbContent: 선택된 경우 엄지의 모양을 맞춤설정하는 데 사용합니다.
    • colors: 트랙과 엄지의 색상을 맞춤설정하는 데 사용합니다.

이 가이드가 포함된 컬렉션

이 가이드는 더 광범위한 Android 개발 목표를 다루는 선별된 빠른 가이드 컬렉션의 일부입니다.

컴포저블 함수를 사용하면 Material Design 디자인 시스템을 기반으로 아름다운 UI 구성요소를 쉽게 만들 수 있습니다.

궁금한 점이나 의견이 있나요?

자주 묻는 질문 페이지로 이동하여 빠른 가이드에 관해 알아보거나 Google에 문의하여 의견을 알려주세요.