原生移动开发 / 系统课时
Scaffold 与应用栏
Scaffold 与应用栏
本节用一个可运行的任务页把 Scaffold、TopAppBar、FloatingActionButton 与 Snackbar 组合起来。完成后你会知道这些组件各自负责什么、如何通过槽位协作,以及为什么正文必须处理 Scaffold 提供的内边距。
学习目标
- 能用
Scaffold组织顶部应用栏、正文、悬浮按钮和 Snackbar。 - 能正确处理
innerPadding,避免正文被应用栏或系统区域遮挡。 - 能通过
SnackbarHostState在用户操作后显示短暂反馈。
Scaffold 负责整屏骨架
Scaffold 不是普通的纵向布局,而是 Material 3 为常见页面结构提供的“槽位容器”。顶部栏放进 topBar,悬浮主操作放进 floatingActionButton,Snackbar 宿主放进 snackbarHost,真正的业务内容则写在 content 中。
最容易遗漏的是 content 参数中的 innerPadding。Scaffold 会计算应用栏和系统区域占用的空间,但不会自动把这个间距应用到你的正文,因此通常要把它传给正文根布局的 Modifier.padding(innerPadding)。
组合应用栏、FAB 与 Snackbar
下面示例以 namespace = "com.example.androidbasics" 的 Compose Material 3 空项目为基线,可直接替换 MainActivity.kt。点击右下角 FAB 会增加计数,并通过 Snackbar 给出反馈。
package com.example.androidbasics
import android.os.Bundle
import androidx.activity.ComponentActivity
import androidx.activity.compose.setContent
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.padding
import androidx.compose.material3.ExperimentalMaterial3Api
import androidx.compose.material3.FloatingActionButton
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.Scaffold
import androidx.compose.material3.SnackbarHost
import androidx.compose.material3.SnackbarHostState
import androidx.compose.material3.Text
import androidx.compose.material3.TopAppBar
import androidx.compose.runtime.Composable
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableIntStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.rememberCoroutineScope
import androidx.compose.runtime.setValue
import androidx.compose.ui.Modifier
import androidx.compose.ui.unit.dp
import kotlinx.coroutines.launch
class MainActivity : ComponentActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContent {
MaterialTheme {
ScaffoldDemo()
}
}
}
}
@OptIn(ExperimentalMaterial3Api::class)
@Composable
fun ScaffoldDemo() {
val snackbarHostState = remember { SnackbarHostState() }
val scope = rememberCoroutineScope()
var count by remember { mutableIntStateOf(0) }
Scaffold(
topBar = {
TopAppBar(title = { Text("任务中心") })
},
snackbarHost = {
SnackbarHost(hostState = snackbarHostState)
},
floatingActionButton = {
FloatingActionButton(
onClick = {
count++
// showSnackbar 是挂起函数,因此从组合感知的协程作用域启动。
scope.launch {
snackbarHostState.showSnackbar("已创建第 $count 个条目")
}
}
) {
Text("+")
}
}
) { innerPadding ->
Column(
modifier = Modifier
.padding(innerPadding)
.padding(24.dp)
) {
Text(
text = "当前条目:$count",
style = MaterialTheme.typography.headlineSmall
)
Text("点击右下角按钮创建一个条目。")
}
}
}预期结果
页面顶部显示“任务中心”,正文显示当前条目数量,右下角显示“+”悬浮按钮。
每点击一次按钮,数量加 1,并在页面底部短暂显示“已创建第 N 个条目”的 Snackbar。如果你的项目包名不同,需要同步修改第一行 package,并保证 Activity 的声明仍指向这个 MainActivity。示例中的 N 会随点击次数变化。
理解 Snackbar 的状态流
SnackbarHostState 保存 Snackbar 的展示请求,SnackbarHost 负责把这些请求渲染到 Scaffold 对应槽位。showSnackbar() 是挂起函数,所以不能直接在 onClick 中当普通函数调用;这里使用 rememberCoroutineScope() 获得与当前组合生命周期关联的协程作用域。
不要用一个布尔值手写“显示/隐藏 Snackbar”的整套状态。对于一次性消息,直接让 SnackbarHostState 管理排队、展示和消失更简单,也更符合组件设计。
避免三个常见布局错误
第一,忘记应用 innerPadding 会让正文顶到 TopAppBar 下方,甚至与系统栏重叠。第二,把 FAB 手工放进 Box 的固定坐标中,会失去 Scaffold 对窗口和其他槽位的协调。第三,创建了 SnackbarHostState 却没有把对应 SnackbarHost 传给 snackbarHost,调用 showSnackbar() 后页面也不会出现消息。
当页面同时需要应用栏、底部栏、FAB 或 Snackbar 中的多个区域时,优先让 Scaffold 管理整屏结构;如果只是一个局部卡片或简单的 Column,则没有必要为了“统一”而套上 Scaffold。