Scaffold

В Material Design каркас — это фундаментальная структура, обеспечивающая стандартизированную платформу для сложных пользовательских интерфейсов. Он объединяет различные части пользовательского интерфейса, такие как панели приложений и плавающие кнопки действий, придавая приложениям целостный вид.

Пример

Composable Scaffold предоставляет простой API, который можно использовать для быстрой сборки структуры вашего приложения в соответствии с рекомендациями Material Design. Scaffold принимает несколько компонуемых объектов в качестве параметров. Среди них следующие:

  • topBar : панель приложения в верхней части экрана.
  • bottomBar : панель приложения в нижней части экрана.
  • floatingActionButton : кнопка, которая нависает над правым нижним углом экрана и которую можно использовать для отображения ключевых действий.

Более подробные примеры того, как можно реализовать как верхнюю, так и нижнюю панели приложений, см. на странице «Панели приложений».

Вы также можете передавать содержимое Scaffold так же, как и в другие контейнеры. Он передает значение innerPadding в лямбда- content , которое затем можно использовать в дочерних составных объектах.

В следующем примере представлен полный пример того, как можно реализовать Scaffold . Он содержит верхнюю панель приложения, нижнюю панель приложения и кнопку плавающего действия, которая взаимодействует с внутренним состоянием Scaffold .

@Composable
fun ScaffoldExample() {
   
var presses by remember { mutableIntStateOf(0) }

   
Scaffold(
        topBar
= {
           
TopAppBar(
                colors
= topAppBarColors(
                    containerColor
= MaterialTheme.colorScheme.primaryContainer,
                    titleContentColor
= MaterialTheme.colorScheme.primary,
               
),
                title
= {
                   
Text("Top app bar")
               
}
           
)
       
},
        bottomBar
= {
           
BottomAppBar(
                containerColor
= MaterialTheme.colorScheme.primaryContainer,
                contentColor
= MaterialTheme.colorScheme.primary,
           
) {
               
Text(
                    modifier
= Modifier
                       
.fillMaxWidth(),
                    textAlign
= TextAlign.Center,
                    text
= "Bottom app bar",
               
)
           
}
       
},
        floatingActionButton
= {
           
FloatingActionButton(onClick = { presses++ }) {
               
Icon(Icons.Default.Add, contentDescription = "Add")
           
}
       
}
   
) { innerPadding ->
       
Column(
            modifier
= Modifier
               
.padding(innerPadding),
            verticalArrangement
= Arrangement.spacedBy(16.dp),
       
) {
           
Text(
                modifier
= Modifier.padding(8.dp),
                text
=
               
"""
                    This is an example of a scaffold. It uses the Scaffold composable's parameters to create a screen with a simple top app bar, bottom app bar, and floating action button.

                    It also contains some basic inner content, such as this text.

                    You have pressed the floating action button $presses times.
                """
.trimIndent(),
           
)
       
}
   
}
}

Эта реализация выглядит следующим образом:

Реализация scaffold, содержащая простые верхнюю и нижнюю панели приложений, а также плавающую кнопку действия, которая выполняет итерацию счетчика. Внутреннее содержимое каркаса — это простой текст, объясняющий компонент.
Рисунок 1. Реализация каркаса.

Дополнительные ресурсы