Barra de ferramentas flutuante

A barra de ferramentas flutuante fica acima do conteúdo do corpo. É melhor usá-la para ações contextuais relevantes para o conteúdo do corpo ou a página específica.

É possível posicionar uma barra de ferramentas flutuante em qualquer lugar da tela para que ela flutue sobre o restante do conteúdo, oferecendo posicionamento versátil e espaço para várias ações.

Como usar a barra de ferramentas flutuante

  • As barras de ferramentas flutuantes mostram controles relevantes para a página atual.
  • As barras de ferramentas flutuantes podem atuar como controles de navegação entre páginas relacionadas em uma hierarquia de produtos.
  • Se mais ações forem necessárias, use um menu flutuante.
  • O contêiner da barra de ferramentas flutuante precisa permanecer totalmente visível na tela.
  • Escolha as ações mais importantes para mostrar na tela por padrão.

Layout e cores

As barras de ferramentas flutuantes podem ser horizontais (HorizontalFloatingToolbar) ou verticais (VerticalFloatingToolbar) e podem usar esquemas de cores padrão ou vibrantes do FloatingToolbarDefaults.

Barra de ferramentas flutuante horizontal do tema claro  Barra de ferramentas flutuante vertical do tema claro 
Figura 1. Barras de ferramentas flutuantes horizontais e verticais.

Barra de ferramentas flutuante com um FAB

Use um botão de ação flutuante (FAB) para a ação de maior prioridade na visualização ou para complementar os controles da barra de ferramentas.

Barra de ferramentas flutuante horizontal de tema claro com FAB  Barra de ferramentas flutuante vertical de tema claro com FAB 
Figura 2. Barras de ferramentas flutuantes com FAB.

Exemplos

Barra de ferramentas flutuante horizontal expansível

Aplique Modifier.floatingToolbarVerticalNestedScroll a um contêiner rolável para que HorizontalFloatingToolbar recolha automaticamente as ações iniciais e finais quando o usuário rolar para baixo e as expanda ao rolar para cima:

@Composable
fun ExpandableHorizontalFloatingToolbarSample() {
    var expanded by rememberSaveable { mutableStateOf(true) }
    Scaffold { innerPadding ->
        Box(Modifier.padding(innerPadding)) {
            HorizontalFloatingToolbar(
                modifier =
                    Modifier.align(Alignment.BottomCenter)
                        .offset(y = -FloatingToolbarDefaults.ScreenOffset)
                        .zIndex(1f),
                expanded = expanded,
                leadingContent = {
                    IconButton(onClick = { /* doSomething() */ }) {
                        Icon(painter = rememberVectorPainter(AppIcons.Edit), contentDescription = "Edit")
                    }
                    IconButton(onClick = { /* doSomething() */ }) {
                        Icon(painter = rememberVectorPainter(AppIcons.Favorite), contentDescription = "Favorite")
                    }
                },
                trailingContent = {
                    IconButton(onClick = { /* doSomething() */ }) {
                        Icon(painter = rememberVectorPainter(AppIcons.Share), contentDescription = "Share")
                    }
                },
                content = {
                    FilledIconButton(
                        modifier = Modifier.width(64.dp),
                        onClick = { /* doSomething() */ },
                    ) {
                        Icon(painter = rememberVectorPainter(AppIcons.Add), contentDescription = "Add")
                    }
                },
            )
            // ...
        }
    }
}

Barra de ferramentas flutuante vertical expansível

Use VerticalFloatingToolbar fixado na lateral da tela quando o espaço de layout vertical for adequado à hierarquia da tela. Assim como a variante horizontal, ela pode ser expandida e recolhida em resposta a gestos de rolagem:

@Composable
fun ExpandableVerticalFloatingToolbarSample() {
    var expanded by rememberSaveable { mutableStateOf(true) }
    Scaffold { innerPadding ->
        Box(Modifier.padding(innerPadding)) {
            VerticalFloatingToolbar(
                modifier =
                    Modifier.align(Alignment.CenterEnd)
                        .offset(x = -FloatingToolbarDefaults.ScreenOffset)
                        .zIndex(1f),
                expanded = expanded,
                leadingContent = {
                    IconButton(onClick = { /* doSomething() */ }) {
                        Icon(painter = rememberVectorPainter(AppIcons.Edit), contentDescription = "Edit")
                    }
                    IconButton(onClick = { /* doSomething() */ }) {
                        Icon(painter = rememberVectorPainter(AppIcons.Favorite), contentDescription = "Favorite")
                    }
                },
                trailingContent = {
                    IconButton(onClick = { /* doSomething() */ }) {
                        Icon(painter = rememberVectorPainter(AppIcons.Share), contentDescription = "Share")
                    }
                },
                content = {
                    FilledIconButton(
                        modifier = Modifier.height(64.dp),
                        onClick = { /* doSomething() */ },
                    ) {
                        Icon(painter = rememberVectorPainter(AppIcons.Add), contentDescription = "Add")
                    }
                },
            )
            // ...
        }
    }
}

Barra de ferramentas flutuante rolável

Para deslizar toda a barra de ferramentas flutuante para fora da tela ao rolar, em vez de recolher os itens, transmita FloatingToolbarDefaults.exitAlwaysScrollBehavior para Modifier.nestedScroll e o parâmetro scrollBehavior da barra de ferramentas:

@Composable
fun ScrollableHorizontalFloatingToolbarSample() {
    val exitAlwaysScrollBehavior =
        FloatingToolbarDefaults.exitAlwaysScrollBehavior(
            exitDirection = FloatingToolbarExitDirection.Bottom
        )
    Scaffold(modifier = Modifier.nestedScroll(exitAlwaysScrollBehavior)) { innerPadding ->
        Box(Modifier.padding(innerPadding)) {
            HorizontalFloatingToolbar(
                modifier =
                    Modifier.align(Alignment.BottomCenter)
                        .offset(y = -FloatingToolbarDefaults.ScreenOffset)
                        .zIndex(1f),
                expanded = true,
                leadingContent = {
                    IconButton(onClick = { /* doSomething() */ }) {
                        Icon(painter = rememberVectorPainter(AppIcons.Edit), contentDescription = "Edit")
                    }
                    IconButton(onClick = { /* doSomething() */ }) {
                        Icon(painter = rememberVectorPainter(AppIcons.Favorite), contentDescription = "Favorite")
                    }
                },
                trailingContent = {
                    IconButton(onClick = { /* doSomething() */ }) {
                        Icon(painter = rememberVectorPainter(AppIcons.Share), contentDescription = "Share")
                    }
                },
                content = {
                    FilledIconButton(
                        modifier = Modifier.width(64.dp),
                        onClick = { /* doSomething() */ },
                    ) {
                        Icon(painter = rememberVectorPainter(AppIcons.Add), contentDescription = "Add")
                    }
                },
                scrollBehavior = exitAlwaysScrollBehavior,
            )
            // ...
        }
    }
}