Botão de ação flutuante

Um botão de ação flutuante (FAB, na sigla em inglês) é um botão de alta ênfase que permite ao usuário realizar uma ação principal em um aplicativo. Ele promove uma única ação focada, que é o caminho mais comum que um usuário pode seguir, e geralmente fica fixado no canto inferior direito da tela.

Considere estes três casos de uso em que você pode usar um FAB:

  • Criar um novo item: em um app de anotações, um FAB pode ser usado para criar rapidamente uma nova nota.
  • Adicionar novo contato: em um app de chat, um FAB pode abrir uma interface que permite ao usuário adicionar alguém a uma conversa.
  • Centralizar local: em uma interface de mapa, um FAB pode centralizar o mapa no local atual do usuário.

No Material Design, há quatro tipos de FAB:

  • FAB: um botão de ação flutuante de tamanho comum.
  • FAB pequeno: um botão de ação flutuante menor.
  • FAB grande: um botão de ação flutuante maior.
  • FAB estendido: um botão de ação flutuante que contém mais do que apenas um ícone.
Um exemplo de cada um dos quatro componentes de botão de ação flutuante.
Figura 1. Os quatro tipos de botão de ação flutuante.

Superfície da API

Embora existam vários elementos que podem ser usados para criar botões de ação flutuantes consistentes com o Material Design, os parâmetros deles não são muito diferentes. Entre os principais parâmetros que você precisa considerar estão:

  • onClick: a função chamada quando o usuário pressiona o botão.
  • containerColor: a cor do botão.
  • contentColor: a cor do ícone.

Botão de ação flutuante

Para criar um botão de ação flutuante geral, use o elemento de composição básico FloatingActionButton. O exemplo abaixo demonstra uma implementação básica de um FAB:

@Composable
fun Example(onClick: () -> Unit) {
    FloatingActionButton(
        onClick = { onClick() },
    ) {
        Icon(painter = rememberVectorPainter(AppIcons.Add), "Floating action button.")
    }
}

Essa implementação é mostrada abaixo:

Figura 2. Um botão de ação flutuante.

Botão pequeno

Para criar um botão de ação flutuante pequeno, use o elemento combinável SmallFloatingActionButton. O exemplo a seguir demonstra como fazer isso, com a adição de cores personalizadas.

@Composable
fun SmallExample(onClick: () -> Unit) {
    SmallFloatingActionButton(
        onClick = { onClick() },
        containerColor = MaterialTheme.colorScheme.secondaryContainer,
        contentColor = MaterialTheme.colorScheme.secondary
    ) {
        Icon(painter = rememberVectorPainter(AppIcons.Add), "Small floating action button.")
    }
}

Essa implementação é mostrada abaixo:

Figura 3. Um botão de ação flutuante pequeno.

Botão grande

Para criar um botão de ação flutuante grande, use o elemento combinável LargeFloatingActionButton. Esse elemento combinável não é muito diferente dos outros exemplos, exceto pelo fato de que ele resulta em um botão maior.

Confira a seguir uma implementação simples de um FAB grande.

@Composable
fun LargeExample(onClick: () -> Unit) {
    LargeFloatingActionButton(
        onClick = { onClick() },
        shape = CircleShape,
    ) {
        Icon(painter = rememberVectorPainter(AppIcons.Add), "Large floating action button")
    }
}

Essa implementação é mostrada abaixo:

Figura 4. Um botão de ação flutuante grande.

Botão estendido

É possível criar botões de ação flutuantes mais complexos com o elemento combinável ExtendedFloatingActionButton. A principal diferença entre ele e FloatingActionButton é que ele tem parâmetros icon e text dedicados. Eles permitem criar um botão com conteúdo mais complexo que é dimensionado para se ajustar ao conteúdo de forma adequada.

O snippet a seguir demonstra como implementar ExtendedFloatingActionButton, com valores de exemplo transmitidos para icon e text.

@Composable
fun ExtendedExample(onClick: () -> Unit) {
    ExtendedFloatingActionButton(
        onClick = { onClick() },
        icon = { Icon(painter = rememberVectorPainter(AppIcons.Edit), "Extended floating action button.") },
        text = { Text(text = "Extended FAB") },
    )
}

Essa implementação é mostrada abaixo:

Figura 5. Um botão de ação flutuante com texto e um ícone.

Atualização do M3 Expressive

O FAB oferece outros tamanhos para corresponder ao FAB estendido e opções de cores expandidas, incluindo MediumFloatingActionButton, que é recomendado para a maioria das situações, além dos tamanhos de FAB atuais.

Botões de ação flutuantes com variantes de cor e tamanho expressivas.
Figura 6. Variações de cor e tamanho do botão de ação flutuante do Material 3 Expressive.

Para mais informações sobre as atualizações do M3 Expressive para botões de ação flutuantes, consulte as diretrizes do botão de ação flutuante do Material Design 3.

Botão de ação flutuante médio

O FAB médio é recomendado para a maioria das situações e funciona melhor em janelas compactas e médias. Use-o para ações importantes sem ocupar muito espaço.

O snippet abaixo demonstra como implementar um botão de ação flutuante médio usando MediumFloatingActionButton:

@Composable
fun MediumFloatingActionButtonSample() {
    MediumFloatingActionButton(onClick = {}) {
        Icon(
            painter = rememberVectorPainter(AppIcons.Add),
            contentDescription = "Add",
            modifier = Modifier.size(FloatingActionButtonDefaults.MediumIconSize),
        )
    }
}

Outros recursos