Barra degli strumenti mobile

La barra degli strumenti mobile si trova sopra i contenuti del corpo. È consigliabile utilizzarlo per azioni contestuali pertinenti ai contenuti del corpo o alla pagina specifica.

Puoi posizionare una barra degli strumenti mobile in qualsiasi punto dello schermo in modo che fluttui sopra il resto dei contenuti, offrendo un posizionamento versatile e spazio per più azioni.

Utilizzo della barra degli strumenti mobile

  • Le barre degli strumenti mobili mostrano i controlli pertinenti alla pagina corrente.
  • Le barre degli strumenti mobili possono fungere da controlli di navigazione tra pagine correlate in una gerarchia di prodotti.
  • Se sono necessarie più azioni, utilizza un menu extra.
  • Il contenitore della barra degli strumenti mobile deve rimanere completamente visibile sullo schermo.
  • Scegli le azioni più importanti da mostrare sullo schermo per impostazione predefinita.

Layout e colori

Le barre degli strumenti mobili possono essere orizzontali (HorizontalFloatingToolbar) o verticali (VerticalFloatingToolbar) e possono utilizzare combinazioni di colori standard o vivaci di FloatingToolbarDefaults.

Barra degli strumenti mobile orizzontale con tema chiaro  Barra degli strumenti mobile verticale con tema chiaro 
Figura 1. Barre degli strumenti mobili orizzontali e verticali.

Barra degli strumenti mobile con un FAB

Utilizza un Floating Action Button (FAB) associato per l'azione con la priorità più alta nella visualizzazione o per integrare i controlli della barra degli strumenti.

Barra degli strumenti mobile orizzontale con tema chiaro e FAB  Barra degli strumenti mobile verticale con FAB, tema chiaro 
Figura 2. Barre degli strumenti mobili con FAB.

Esempi

Barra degli strumenti mobile orizzontale espandibile

Applica Modifier.floatingToolbarVerticalNestedScroll a un contenitore scorrevole in modo che HorizontalFloatingToolbar comprima automaticamente le azioni iniziali e finali quando l'utente scorre verso il basso e le espanda quando scorre verso l'alto:

@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 degli strumenti mobile verticale espandibile

Utilizza VerticalFloatingToolbar ancorato al lato dello schermo quando lo spazio del layout verticale è adatto alla gerarchia dello schermo. Come la variante orizzontale, può espandersi e comprimersi in risposta ai gesti di scorrimento:

@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 degli strumenti mobile scorrevole

Per far scorrere l'intera barra degli strumenti mobile fuori dallo schermo durante lo scorrimento anziché comprimere i suoi elementi, passa FloatingToolbarDefaults.exitAlwaysScrollBehavior sia a Modifier.nestedScroll sia al parametro scrollBehavior della barra degli strumenti:

@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,
            )
            // ...
        }
    }
}