原生移动开发 / 系统课时
Material 3 常用组件
Material 3 常用组件
本节用一个最小页面串起 Card、Surface、Dialog 与 NavigationBar。你会看到它们分别解决“内容分组、主题表面、模态交互、顶层目的地切换”四类问题,并能在同一页面中正确组合,而不是把所有容器都当成普通 Column 使用。
学习目标
- 能根据职责选择
Card、Surface、Dialog与NavigationBar。 - 能用 Material 3 主题提供的颜色、形状和排版保持视觉一致。
- 能维护导航选中状态与 Dialog 显示状态,并验证交互结果。
先按职责选择组件
这四个组件看起来都“能装内容”,但职责不同。Card 适合承载一组语义完整、可独立识别的内容;Surface 更基础,用来提供符合 Material 主题的背景、内容颜色、形状和高程;Dialog 把需要用户集中处理的内容放到主界面上层;NavigationBar 则用于紧凑窗口中几个主要目的地之间的切换。
| 组件 | 主要职责 | 典型用法 |
|---|---|---|
Card |
聚合一块独立内容 | 商品、消息、任务摘要 |
Surface |
提供主题化表面 | 页面背景、自定义容器、Dialog 外壳 |
Dialog |
暂时打断主界面并请求处理 | 确认、输入、选项 |
NavigationBar |
切换顶层目的地 | 首页、搜索、个人页等 |
Surface 和 Card 不应仅凭“哪个有圆角”来选择。先判断内容是否需要作为一个独立信息单元被识别,再决定是否用 Card;如果只是需要主题化的背景与形状,Surface 往往更直接。
用一个页面组合四种组件
下面示例同样基于 namespace = "com.example.androidbasics" 的 Compose Material 3 空项目。页面主体使用 Surface,任务内容放入 Card;点击卡片打开自定义 Dialog,底部 NavigationBar 切换“首页”和“设置”的选中状态。
package com.example.androidbasics
import android.os.Bundle
import androidx.activity.ComponentActivity
import androidx.activity.compose.setContent
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.Row
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.foundation.layout.padding
import androidx.compose.material3.Button
import androidx.compose.material3.Card
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.NavigationBar
import androidx.compose.material3.NavigationBarItem
import androidx.compose.material3.Surface
import androidx.compose.material3.Text
import androidx.compose.material3.TextButton
import androidx.compose.runtime.Composable
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableIntStateOf
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.saveable.rememberSaveable
import androidx.compose.runtime.setValue
import androidx.compose.ui.Modifier
import androidx.compose.ui.unit.dp
import androidx.compose.ui.window.Dialog
class MainActivity : ComponentActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContent {
MaterialTheme {
MaterialComponentsDemo()
}
}
}
}
@Composable
fun MaterialComponentsDemo() {
val destinations = listOf("首页", "设置")
var selectedIndex by rememberSaveable { mutableIntStateOf(0) }
var showDialog by rememberSaveable { mutableStateOf(false) }
Surface(modifier = Modifier.fillMaxSize()) {
Column {
Column(
modifier = Modifier
.weight(1f)
.padding(24.dp)
) {
Text(
text = "当前页面:${destinations[selectedIndex]}",
style = MaterialTheme.typography.headlineSmall
)
Card(
onClick = { showDialog = true },
modifier = Modifier
.fillMaxWidth()
.padding(top = 20.dp)
) {
Column(modifier = Modifier.padding(20.dp)) {
Text(
text = "今日任务",
style = MaterialTheme.typography.titleMedium
)
Text("点击卡片查看确认对话框。")
}
}
}
NavigationBar {
destinations.forEachIndexed { index, label ->
NavigationBarItem(
selected = selectedIndex == index,
onClick = { selectedIndex = index },
// 为避免额外图标依赖,示例用短文字占据 icon 槽位。
icon = { Text(if (index == 0) "H" else "S") },
label = { Text(label) }
)
}
}
}
if (showDialog) {
Dialog(onDismissRequest = { showDialog = false }) {
Surface(
shape = MaterialTheme.shapes.extraLarge,
tonalElevation = 6.dp
) {
Column(modifier = Modifier.padding(24.dp)) {
Text(
text = "确认完成",
style = MaterialTheme.typography.headlineSmall
)
Text(
text = "要把“今日任务”标记为已完成吗?",
modifier = Modifier.padding(top = 12.dp)
)
Row(
modifier = Modifier
.fillMaxWidth()
.padding(top = 20.dp),
horizontalArrangement = Arrangement.End
) {
TextButton(onClick = { showDialog = false }) {
Text("取消")
}
Button(
onClick = { showDialog = false },
modifier = Modifier.padding(start = 8.dp)
) {
Text("确认")
}
}
}
}
}
}
}
}预期结果
页面显示“当前页面:首页”和一张“今日任务”卡片,底部显示“首页”“设置”两个导航项。
点击“设置”后标题变为“当前页面:设置”,选中状态同步变化。
点击任务卡片后出现居中的模态对话框;点击“取消”“确认”或对话框外部后,对话框关闭。如果项目包名不同,需要同步修改示例中的 package。这里用 H、S 代替图标只是为了保持示例零额外图标依赖;真实项目应使用有语义的图标,并为无文字图标提供可访问的内容描述。
把状态放在真正拥有它的地方
selectedIndex 决定哪个 NavigationBarItem 处于选中状态,也决定正文显示哪个目的地;它属于页面级状态。showDialog 只控制对话框是否存在,同样由页面持有。两者使用 rememberSaveable,在可保存状态的重建场景中可以恢复简单值。
Dialog 的 onDismissRequest 不能遗漏。用户点击对话框外部或触发返回操作时,Compose 会通过这个回调请求关闭;如果回调里不更新状态,界面就会保持打开。自定义 Dialog 本身只负责模态层,实际的 Material 外观由内部 Surface 提供。
组件组合的边界
NavigationBar 应承载少量、稳定且地位接近的顶层目的地,不适合把“保存”“删除”这类动作当作导航项。Card 也不要层层嵌套,否则内容层级会变得含糊;需要普通分组时优先考虑 Column、Row 或 Surface。
Material 3 组件的价值不只是默认圆角和颜色,而是把主题、状态与交互语义放进一致的组件契约中。先按职责选择组件,再用 MaterialTheme 调整视觉,通常比从裸布局开始手工模拟 Material 外观更稳定。