Плавающая панель инструментов

Плавающая панель инструментов находится над основным контентом. Она лучше всего подходит для контекстных действий, связанных с основным контентом или определенной страницей.

Плавающие панели инструментов можно размещать в любой части экрана поверх остального контента. Они позволяют выполнять множество действий.

Как использовать плавающую панель инструментов

  • На плавающих панелях инструментов показаны элементы управления, относящиеся к текущей странице.
  • Плавающие панели инструментов могут действовать как элементы управления навигацией между связанными страницами в иерархии продуктов.
  • Если требуется больше действий, используйте дополнительное меню.
  • Контейнер плавающей панели инструментов должен быть полностью виден на экране.
  • Выберите самые важные действия, которые будут показываться на экране по умолчанию.

Макет и цвета

Плавающие панели инструментов могут быть горизонтальными (HorizontalFloatingToolbar) или вертикальными (VerticalFloatingToolbar). Для них можно использовать стандартные или яркие цветовые схемы из FloatingToolbarDefaults.

Светлая тема, горизонтальная плавающая панель инструментов  Вертикальная плавающая панель инструментов в светлой теме 
Рисунок 1. Горизонтальная и вертикальная плавающие панели инструментов.

Плавающая панель инструментов с FAB

Используйте сопутствующую плавающую кнопку действия (FAB) для самого приоритетного действия в представлении или для дополнения элементов управления на панели инструментов.

Горизонтальная плавающая панель инструментов со светлой темой и плавающей кнопкой действия  Вертикальная плавающая панель инструментов со светлой темой и плавающей кнопкой действия 
Рисунок 2. Плавающие панели инструментов с FAB.

Примеры

Раскрывающаяся горизонтальная плавающая панель инструментов

Примените Modifier.floatingToolbarVerticalNestedScroll к прокручиваемому контейнеру, чтобы HorizontalFloatingToolbar автоматически сворачивал начальные и конечные действия, когда пользователь прокручивает вниз, и разворачивал их при прокрутке вверх:

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

Раскрывающаяся вертикальная плавающая панель инструментов

Используйте VerticalFloatingToolbar, закрепленную сбоку экрана, если вертикальный макет подходит для иерархии экрана. Как и горизонтальный вариант, она может расширяться и сворачиваться в ответ на жесты прокрутки:

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

Плавающая панель инструментов с прокруткой

Чтобы при прокрутке убирать с экрана всю плавающую панель инструментов, а не сворачивать ее элементы, передайте FloatingToolbarDefaults.exitAlwaysScrollBehavior в Modifier.nestedScroll и параметр scrollBehavior панели инструментов:

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