快捷信息栏

Snackbar 组件可用作显示在屏幕底部的简短通知。它可在不中断用户体验的情况下提供有关操作或操作的反馈。抽屉式菜单会在几秒钟后消失。用户还可以通过执行操作（例如点按按钮）来关闭这些动作条。

请考虑以下三个可能需要使用抽屉式动作条的用例：

  • 操作确认：用户删除电子邮件或消息后，系统会显示一个动作条来确认操作并提供“撤消”选项。
  • 网络状态：当应用失去互联网连接时，系统会弹出一个动作条，指明应用目前处于离线状态。
  • 数据提交：成功提交表单或更新设置后，系统会在通知栏中显示更改已成功保存。

基本示例

如需实现抽屉式动作条，您首先需要创建 SnackbarHost，其中包含 SnackbarHostState 属性。SnackbarHostState 可提供对 showSnackbar() 函数的访问权限，您可以使用该函数显示信息提示栏。

该挂起函数需要 CoroutineScope（例如，使用 rememberCoroutineScope），并可被调用以响应界面事件，从而在 Scaffold 中显示 Snackbar。

val scope = rememberCoroutineScope()
val snackbarHostState = remember { SnackbarHostState() }
Scaffold(
    snackbarHost = {
        SnackbarHost(hostState = snackbarHostState)
    },
    floatingActionButton = {
        ExtendedFloatingActionButton(
            text = { Text("Show snackbar") },
            icon = { Icon(Icons.Filled.Image, contentDescription = "") },
            onClick = {
                scope.launch {
                    snackbarHostState.showSnackbar("Snackbar")
                }
            }
        )
    }
) { contentPadding ->
    // Screen content
}
MaterialLayoutSnippets.kt

包含操作的 Snackbar

您可以提供可选操作，并调整 Snackbar 的时长。snackbarHostState.showSnackbar() 函数可接受额外的 actionLabel 和 duration 参数，并返回 SnackbarResult。

val scope = rememberCoroutineScope()
val snackbarHostState = remember { SnackbarHostState() }
Scaffold(
    snackbarHost = {
        SnackbarHost(hostState = snackbarHostState)
    },
    floatingActionButton = {
        ExtendedFloatingActionButton(
            text = { Text("Show snackbar") },
            icon = { Icon(Icons.Filled.Image, contentDescription = "") },
            onClick = {
                scope.launch {
                    val result = snackbarHostState
                        .showSnackbar(
                            message = "Snackbar",
                            actionLabel = "Action",
                            // Defaults to SnackbarDuration.Short
                            duration = SnackbarDuration.Indefinite
                        )
                    when (result) {
                        SnackbarResult.ActionPerformed -> {
                            /* Handle snackbar action performed */
                        }
                        SnackbarResult.Dismissed -> {
                            /* Handle snackbar dismissed */
                        }
                    }
                }
            }
        )
    }
) { contentPadding ->
    // Screen content
}
MaterialLayoutSnippets.kt

您可以使用 snackbarHost 参数提供自定义 Snackbar。如需了解详情，请参阅 SnackbarHost API 参考文档。