このページは Cloud Translation API によって翻訳されました。

Scaffold

マテリアルデザインでは、スキャフォールドは複雑なユーザーインターフェースに標準化されたプラットフォームを提供する基本構造です。アプリバーやフローティングアクションボタンなど、UI のさまざまな部分をまとめ、アプリに統一感のある外観と操作性をもたらします。

例

Scaffold コンポーザブルは、マテリアルデザインのガイドラインに沿ってアプリの構造をすばやく組み立てることができる簡単な API を提供します。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.kt

これを実装すると次のようになります。

シンプルなトップアプリバーとボトムアプリバー、カウンタを反復処理するフローティングアクションボタンを含むスキャフォールドの実装。スキャフォールドの内部コンテンツは、コンポーネントを説明する単純なテキストです。 — **図 1.** スキャフォールドの実装。

参考情報

アプリバー