Добавьте переключатель, который пользователи смогут переключать

Компонент Switch позволяет пользователям переключаться между двумя состояниями: отмечено и не отмечено. Используйте переключатель, чтобы позволить пользователю выполнить одно из следующих действий:

  • Включить или выключить настройку.
  • Включить или отключить функцию.
  • Выберите вариант.

Компонент состоит из двух частей: ползунка и направляющей. Ползунок — это перемещаемая часть переключателя, а направляющая — это фон. Пользователь может перетаскивать ползунок влево или вправо, чтобы изменить состояние переключателя. Он также может коснуться переключателя, чтобы проверить или сбросить его состояние.

Совместимость версий

Для данной реализации требуется, чтобы в вашем проекте был установлен уровень API 21 или выше.

Зависимости

Реализуйте переключатель

Следующий пример представляет собой минимальную реализацию составного модуля Switch :

Результаты

Простой переключатель, который не отмечен галочкой.
Рисунок 1. Неотмеченный переключатель.
Базовый переключатель, который отмечен.
Рисунок 2. Проверенный переключатель.

Создать пользовательский миниатюрный отпечаток

Для создания пользовательского значка переключателя можно передать любой составной объект в параметр thumbContent . Ниже приведен пример переключателя, использующего пользовательскую иконку для своего значка:

Результаты

В неотмеченном состоянии он выглядит так же, как в примере из предыдущего раздела. Однако, если он отмечен, то в этом случае он выглядит следующим образом:

Переключатель, использующий параметр thumbContent для отображения пользовательской иконки при установке флажка.
Рисунок 3. Переключатель с пользовательской галочкой.

Используйте пользовательские цвета

Используйте параметр colors , чтобы изменить цвет ползунка и дорожки переключателя, учитывая, установлен ли переключатель в положение «отмечен».

Результаты

Переключатель, использующий параметр colors для отображения пользовательских цветов как для большого пальца, так и для кнопки.
Рисунок 4. Переключатель с возможностью настройки цветов.

Ключевые моменты

  • Основные параметры:

    • checked : Начальное состояние переключателя.
    • onCheckedChange : Функция обратного вызова, которая вызывается при изменении состояния переключателя.
    • enabled : Указывает, включен или выключен переключатель.
    • colors : цвета, используемые для переключателя.

  • Расширенные параметры

    • thumbContent : Используйте этот параметр для настройки внешнего вида ползунка при его выборе.
    • colors : Используйте этот параметр для настройки цвета дорожки и ползунка.

Коллекции, содержащие это руководство

Данное руководство является частью подборки кратких руководств, охватывающих более широкие цели разработки под Android:

Узнайте, как компонуемые функции позволяют легко создавать красивые компоненты пользовательского интерфейса на основе системы дизайна Material Design.
Краткий справочник

Есть вопросы или отзывы?

Перейдите на страницу часто задаваемых вопросов и ознакомьтесь с краткими руководствами или свяжитесь с нами и поделитесь своими мыслями.
Перейти к разделу часто задаваемых вопросов Оставить отзыв