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
![Um interruptor básico que não está marcado.](https://developer.android.com/static/develop/ui/compose/images/components/switch-deactivated.png?hl=pt-br)
![Uma chave básica marcada.](https://developer.android.com/static/develop/ui/compose/images/components/switch.png?hl=pt-br)
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:
![Um switch que usa o parâmetro thumbContent para mostrar um ícone personalizado quando marcado.](https://developer.android.com/static/develop/ui/compose/images/components/switch-icon.png?hl=pt-br)
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
![Um botão que usa o parâmetro colors para mostrar um botão com cores personalizadas para o polegar e a tachinha.](https://developer.android.com/static/develop/ui/compose/images/components/switch-colors.png?hl=pt-br)
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:
![](https://developer.android.com/static/images/quick-guides/collection-illustration.png?hl=pt-br)