O componente Switch permite que os usuários alternem entre dois estados: marcado
e desmarcado. Use uma chave para permitir que o usuário faça uma das
seguintes ações:
- Ative ou desative uma configuração.
- Ativar ou desativar um recurso.
- Selecione uma opção.
O componente tem duas partes: o ícone e a faixa. O botão é a parte arrastável do botão e a faixa é o plano de fundo. O usuário pode arrastar o botão para a esquerda ou direita para mudar o estado da chave. Eles também podem tocar no interruptor para verificar e limpar.
Compatibilidade de versões
Essa implementação exige que o minSDK do projeto seja definido como nível 21 da API ou mais recente.
Dependências
Implementar uma chave
O exemplo a seguir é uma implementação mínima do elemento combinável Switch:
Resultados
Criar um polegar personalizado
É possível transmitir qualquer elemento combinável para o parâmetro thumbContent e criar um polegar
personalizado. Confira a seguir um exemplo de alternância que usa um ícone personalizado para o
polegar:
Resultados
A aparência desmarcada é igual ao exemplo na seção anterior. No entanto, quando marcada, essa implementação aparece da seguinte maneira:
Usar cores personalizadas
Use o parâmetro colors para
mudar a cor do botão e da faixa de um interruptor, considerando se o
interruptor está marcado.
Resultados
Pontos principais
Parâmetros básicos:
checked: o estado inicial do switch.onCheckedChange: um callback que é chamado quando o estado do interruptor muda.enabled: indica se a chave está ativada ou desativada.colors: as cores usadas para a troca.
Parâmetros avançados
thumbContent: use para personalizar a aparência do polegar quando ele estiver marcado.colors: use para personalizar a cor da faixa e do ícone.
Coleções que contêm este guia
Este guia faz parte destas coleções selecionadas de guias rápidos que abrangem metas mais amplas de desenvolvimento para Android:
Mostrar componentes interativos
