Os botões permitem que o usuário acione uma ação definida. Há cinco tipos de botão:
Tipo |
Aparência |
Objetivo |
---|---|---|
Preenchido | Plano de fundo sólido com texto em contraste. |
Para ações principais, como "Enviar" e "Salvar". O efeito de sombra enfatiza a importância do botão. |
Tonal | A cor de fundo varia para combinar com a superfície. |
Para ações principais ou significativas. Os botões preenchidos fornecem peso visual e são adequados para ações como "Adicionar ao carrinho" e "Fazer login". |
Elevada | A sombra faz com que ele se destaque. |
Para ações principais ou significativas. Aumente a elevação para destacar o botão. |
Contornado | Apresenta uma borda sem preenchimento. |
Para ações importantes, mas não principais. Os botões com contorno combinam bem com outros para indicar ações secundárias e alternativas, como "Cancelar" ou "Voltar". |
Texto | Texto sem plano de fundo ou borda. |
Para ações menos importantes, como links de navegação ou ações secundárias, como "Saiba mais" ou "Ver detalhes". |
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
Criar um botão preenchido
O componente de botão preenchido usa o elemento combinável básico Button
. Ele é
preenchido com uma cor sólida por padrão.
Resultados
![Um botão preenchido com um plano de fundo roxo que mostra a mensagem "filled".](https://developer.android.com/static/develop/ui/compose/images/components/button-filled.png?hl=pt-br)
Criar um botão tonal preenchido
O componente do botão tonal preenchido usa o elemento combinável FilledTonalButton
.
Por padrão, ele é preenchido com uma cor tonal.
Resultados
![Um botão tonal com um fundo roxo claro que diz "filled".](https://developer.android.com/static/develop/ui/compose/images/components/button-tonal.png?hl=pt-br)
Criar um botão de contorno
O componente de botão de contorno usa o elemento combinável OutlinedButton
. Ele
aparece com um contorno por padrão.
Resultados
![Um botão transparente com contorno e borda escura que mostra a mensagem "Outlined".](https://developer.android.com/static/develop/ui/compose/images/components/button-outlined.png?hl=pt-br)
Criar um botão elevado
O componente de botão elevado usa o elemento combinável ElevatedButton
. Ele tem
uma sombra que representa o efeito de elevação por padrão e aparece como
um botão delineado com uma sombra.
Resultados
![Um botão elevado com um plano de fundo cinza que mostra a mensagem "Elevado".](https://developer.android.com/static/develop/ui/compose/images/components/button-elevated.png?hl=pt-br)
Criar um botão de texto
O componente do botão de texto usa o elemento combinável TextButton
. Até ser clicado,
ele aparece apenas como texto. Ele não tem um preenchimento sólido ou contorno por padrão.
Resultados
![Um botão de texto com a mensagem "Text Button"](https://developer.android.com/static/develop/ui/compose/images/components/button-text.png?hl=pt-br)
Pontos principais
onClick
: a função chamada quando o usuário pressiona o botão.enabled
: quando falso, esse parâmetro faz com que o botão apareça indisponível e inativo.colors
: uma instância deButtonColors
que determina as cores usadas no botão.contentPadding
: o padding dentro do botão.
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)