Pływający pasek narzędzi

Pływający pasek narzędzi unosi się nad treścią. Najlepiej używać go do działań kontekstowych związanych z treścią lub konkretną stroną.

Pływający pasek narzędzi możesz umieścić w dowolnym miejscu na ekranie, aby unosił się nad pozostałą zawartością. Dzięki temu możesz go umieścić w dowolnym miejscu i mieć miejsce na wiele działań.

Korzystanie z pływającego paska narzędzi

  • Pływające paski narzędzi wyświetlają elementy sterujące odpowiednie dla bieżącej strony.
  • Pływające paski narzędzi mogą służyć jako elementy sterujące nawigacją między powiązanymi stronami w hierarchii usługi.
  • Jeśli potrzebujesz więcej działań, użyj rozszerzonego menu.
  • Kontener pływającego paska narzędzi powinien być w pełni widoczny na ekranie.
  • Wybierz najważniejsze działania, które mają być domyślnie wyświetlane na ekranie.

Układ i kolory

Pływające paski narzędzi mogą być poziome (HorizontalFloatingToolbar) lub pionowe (VerticalFloatingToolbar) i mogą używać standardowych lub żywych schematów kolorów z FloatingToolbarDefaults.

Poziomy pływający pasek narzędzi w jasnym motywie  Pionowy pływający pasek narzędzi w jasnym motywie 
Rysunek 1. Poziome i pionowe pływające paski narzędzi.

Pływający pasek narzędzi z przyciskiem typu FAB

Użyj towarzyszącego pływającego przycisku polecenia (FAB) do wykonania działania o najwyższym priorytecie w widoku lub do uzupełnienia elementów sterujących paska narzędzi.

Poziomy pływający pasek narzędzi z przyciskiem działania w jasnym motywie  Pionowy pływający pasek narzędzi z przyciskiem działania w jasnym motywie 
Rysunek 2. Pływające paski narzędzi z przyciskiem typu FAB.

Przykłady

Rozwijany poziomy pływający pasek narzędzi

Zastosuj Modifier.floatingToolbarVerticalNestedScroll do kontenera z możliwością przewijania, aby HorizontalFloatingToolbar automatycznie zwijał działania początkowe i końcowe, gdy użytkownik przewija w dół, i rozwijał je, gdy przewija w górę:

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

Rozwijany pionowy pływający pasek narzędzi

Używaj VerticalFloatingToolbar zakotwiczonego z boku ekranu, gdy układ pionowy pasuje do hierarchii ekranu. Podobnie jak wariant poziomy, może się rozwijać i zwijać w odpowiedzi na gesty przewijania:

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

Przewijany pływający pasek narzędzi

Aby podczas przewijania przesunąć cały pływający pasek narzędzi poza ekran, zamiast zwijać jego elementy, przekaż FloatingToolbarDefaults.exitAlwaysScrollBehavior do parametru Modifier.nestedScroll i parametru scrollBehavior paska narzędzi:

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