Компонент Switch
позволяет пользователям переключаться между двумя состояниями: отмечено и не отмечено. Используйте переключатель, чтобы позволить пользователю выполнить одно из следующих действий:
- Включите или выключите настройку.
- Включите или отключите функцию.
- Выберите вариант.
Компонент состоит из двух частей: ползунка и дорожки. Большой палец — это перетаскиваемая часть переключателя, а дорожка — фон. Пользователь может перетащить большой палец влево или вправо, чтобы изменить состояние переключателя. Они также могут нажать на переключатель, чтобы проверить и очистить его.
Совместимость версий
Для этой реализации требуется, чтобы для minSDK вашего проекта был установлен уровень API 21 или выше.
Зависимости
Внедрить переключатель
Следующий пример представляет собой минимальную реализацию составного Switch
:
Результаты
![Базовый переключатель, который не отмечен флажком.](https://developer.android.com/static/develop/ui/compose/images/components/switch-deactivated.png?hl=ru)
![Базовый проверенный коммутатор.](https://developer.android.com/static/develop/ui/compose/images/components/switch.png?hl=ru)
Создать собственный большой палец
Вы можете передать любой компонуемый элемент в качестве параметра thumbContent
, чтобы создать собственный миниатюрный элемент. Ниже приведен пример переключателя, в котором в качестве большого пальца используется собственный значок:
Результаты
Внешний вид без флажка такой же, как в примере в предыдущем разделе. Однако, если этот флажок установлен, эта реализация выглядит следующим образом:
![Переключатель, который использует параметр thumbContent для отображения пользовательского значка, если он установлен.](https://developer.android.com/static/develop/ui/compose/images/components/switch-icon.png?hl=ru)
Используйте собственные цвета
Используйте параметр colors
, чтобы изменить цвет ползунка и дорожки переключателя, принимая во внимание, установлен ли переключатель.
Результаты
![Переключатель, который использует параметр цвета для отображения переключателя с пользовательскими цветами как для большого пальца, так и для кнопки.](https://developer.android.com/static/develop/ui/compose/images/components/switch-colors.png?hl=ru)
Ключевые моменты
Основные параметры:
-
checked
: Исходное состояние переключателя. -
onCheckedChange
: обратный вызов, который вызывается при изменении состояния переключателя. -
enabled
: включен или отключен переключатель. -
colors
: цвета, используемые для переключателя.
-
Расширенные параметры
-
thumbContent
: используйте это, чтобы настроить внешний вид ползунка, когда он отмечен. -
colors
: используйте это, чтобы настроить цвет дорожки и бегунка.
-
Коллекции, содержащие это руководство
Это руководство является частью тщательно подобранной коллекции быстрых руководств, охватывающих более широкие цели разработки Android:
![](https://developer.android.com/static/images/quick-guides/collection-illustration.png?hl=ru)