Material3
谷歌第三代质感设计系统,也是现在 Jetpack Compose 默认推荐的组件库。
M3 核心特点
- 动态配色(Material You 灵魂) 手机壁纸自动提取一套主题色,App 跟着系统颜色自动变,这是 M2 没有的特色。
- 圆角更大、风格柔和,组件视觉更现代,适配平板、折叠屏(自适应布局)
- 统一设计规范:内置一套标准颜色方案、字体排版、圆角、阴影、动效规范
- 组件齐全:Button / Card / TextField / Checkbox / Switch / AlertDialog / Scaffold / TopAppBar / NavigationBar 等开箱即用,不用自己画基础控件
- 内置动画规范,和 Compose 动画体系天然适配
📦 依赖(build.gradle)
implementation "androidx.compose.material3:material3:$版本号"
M2 和 M3不能混用一套主题,包名不一样,API 名字很多都变了(比如 TopAppBar 写法、Scaffold 参数),新项目直接 M3。
🧩 M3 的顶层入口:MaterialTheme
所有 M3 组件必须包裹在 MaterialTheme{} 里面,给子组件提供颜色、字体、形状配置:
@Composable
fun MyAppTheme(
content: @Composable () -> Unit
) {
MaterialTheme(
colorScheme = lightColorScheme(), // 亮色配色;darkColorScheme暗色
typography = Typography(),
shapes = Shapes(),
content = content
)
}
Scaffold
是一个脚手架,帮开发者节省了计算顶部和底部的位置。
常用的参数
@Composable
fun Scaffold(
topBar: @Composable () -> Unit = {}, // 顶部标题栏 TopAppBar
bottomBar: @Composable () -> Unit = {}, // 底部导航栏 NavigationBar
floatingActionButton: @Composable () -> Unit = {}, // FAB悬浮按钮
floatingActionButtonPosition: FabPosition = FabPosition.End, // FAB位置
containerColor: Color = MaterialTheme.colorScheme.background,
contentColor: Color = MaterialTheme.colorScheme.onBackground,
content: @Composable (PaddingValues) -> Unit // ✅ 页面主体内容
)
基本使用
@OptIn(ExperimentalMaterial3Api::class)
@Composable
fun ScaffoldDemo(){
Scaffold(topBar = {
TopAppBar(
title = { Text("页面标题") },
colors = TopAppBarDefaults.topAppBarColors(
// 包括当前导航条和当前状态栏
containerColor = Color(0xFF0000FF), // 顶部栏背景
titleContentColor = Color.White, // 标题文字白色
navigationIconContentColor = Color.White, // 返回箭头颜色
actionIconContentColor = Color.Red
)
)
},
bottomBar = {
NavigationBar {
NavigationBarItem(selected = true, onClick = {}, icon = { Icon(Icons.Default.Home, null) }, label = { Text("首页") })
NavigationBarItem(selected = false, onClick = {}, icon = { Icon(Icons.Default.Person, null) }, label = { Text("我的") })
}
},
floatingActionButton = {
FloatingActionButton(onClick = {}) {
Icon(Icons.Default.Add, contentDescription = "添加")
}
}) { padding ->
// 这个padding是Scaffold自动算出来的:避开topBar、bottomBar、FAB,防止内容被遮挡
println("TEST top ${padding.calculateTopPadding()} bottom ${padding.calculateBottomPadding()} start ${padding.calculateStartPadding(LayoutDirection.Ltr)} end ${padding.calculateRightPadding(LayoutDirection.Ltr)}")
Box(modifier = Modifier.padding(padding).background(color= Color.Green).fillMaxSize()){
Text("Scaffold")
}
}
}
// TEST top 40.0.dp bottom 16.0.dp start 0.0.dp end 0.0.dp
NavController
添加依赖
implementation("androidx.navigation:navigation-compose:2.9.0")
fun NaviDemo(){
var navController = rememberNavController()
NavHost(
navController = navController,
startDestination = "Home"
){
composable("home"){
Home(navController)
}
composable("detail") {
DetailPage(navController)
}
composable("goods/{id}") { entry ->
var id = entry.arguments?.getString("id")
GoodsPage(navController,id=id)
}
}
}
@Composable
fun Home(nav: NavController){
Column(
modifier = Modifier.systemBarsPadding().fillMaxSize().background(color=Color.Green)
) {
Text("首页")
Button(onClick = {
nav.navigate("detail")
}) {
Text("跳转到下一页")
}
Button(onClick = {
nav.navigate("goods/苹果")
}) {
Text("跳转到苹果")
}
Button(onClick = {
nav.navigate("goods/橘子")
}) {
Text("跳转到橘子")
}
}
}
@Composable
fun DetailPage(nav: NavController){
Column(
modifier = Modifier.systemBarsPadding().fillMaxSize().background(color=Color.Blue)
) {
Text("首页")
Button(onClick = {
nav.popBackStack()
}) {
Text("返回上一页")
}
}
}
@Composable
fun GoodsPage(nav: NavController, id: String?){
Column(
modifier = Modifier.systemBarsPadding().fillMaxSize().background(color=Color.Blue)
) {
Text("当前商品是 ${id}")
Button(onClick = {
nav.popBackStack()
}) {
Text("返回上一页")
}
}
}
常用 NavController 方法
// 跳转,压入返回栈
navController.navigate("route")
// 返回上一页(弹出当前页面)
navController.popBackStack()
// popBackStack(route, inclusive = true)
// inclusive=true:把目标路由一起删掉,适合登录→首页,不能回退到登录页
navController.popBackStack("login", inclusive = true)
// 直接回到指定页面,中间全部弹出
navController.navigate("home") {
popUpTo("home") { inclusive = true }
}
// 判断能不能返回(是否还有上一页)
navController.previousBackStackEntry != null
Scanffold和navController
@SuppressLint("RestrictedApi")
@Composable
fun RootPage() {
var scope = rememberCoroutineScope()
val navController = rememberNavController()
var selectedIndex by remember { mutableIntStateOf(0) }
// 把下标和路由绑定,一一对应
val tabRouteList = listOf(
"Home",
"Favorite",
"mine"
)
var tabs = remember {
listOf(
TabItemData(
icon = Icons.Outlined.Home,
iconSelected = Icons.Filled.Home,
title = "首页",
color = Color.Green
),
TabItemData(
icon = Icons.Outlined.Favorite,
iconSelected = Icons.Filled.Favorite,
title = "收藏",
color = Color.Red
),
TabItemData(
icon = Icons.Outlined.Person,
iconSelected = Icons.Filled.Person,
title = "我的",
color = Color.Cyan
),
)
}
LaunchedEffect(navController) {
navController.visibleEntries.collect { entry ->
Log.d("BackStack", "begin")
val stack = navController.currentBackStack.value
stack.forEach { entry ->
Log.d("BackStack", "Route: ${entry.destination.route}")
}
Log.d("BackStack", "finish")
}
}
Scaffold(
bottomBar = {
NavigationBar {
tabs.forEachIndexed { index, data ->
val isCurrentSelected = index == selectedIndex
NavigationBarItem(selected = isCurrentSelected,
onClick = {
selectedIndex = index
// 这里不会保存之前的状态
// navController.navigate(tabRouteList[index])
navController.navigate(tabRouteList[index]){
launchSingleTop = true
restoreState = true
popUpTo(navController.graph.findStartDestination().id ) {
saveState = true
}
}
},
icon = { Icon(imageVector= if (isCurrentSelected) data.iconSelected else data.icon,data.title
)},
label = { Text("${data.title}") }
)
}
}
},
floatingActionButton = {
FloatingActionButton({
}) {
if(navController.previousBackStackEntry == null ){
Text("上一层没了")
}else{
navController.popBackStack()
Text("返回上一层")
}
}
}
){paddingValues ->
println(paddingValues)
NavHost(
navController = navController,
startDestination = "Home"
){
composable("Home"){
HomePage(navController,color=Color.Green)
}
composable ( "detail" ){
DetailPage(navController)
}
composable("Favorite") {
FavoritePage(navController)
}
composable("mine"){
// MinePage(navController)
Column() {
Text("test")
Button(onClick = {
navController.navigate("mine"){
launchSingleTop = false
}
}) {
Text("下一页")
}
}
}
composable("TestPage"){
Column() {
Text("test")
Button(onClick = {
navController.navigate("TestPage")
}) {
Text("下一页")
}
}
}
}
}
}
@Composable
fun DetailPage(nav: NavController){
Column() {
Text("detailPage")
Button(onClick = {
nav.navigate("detail")
}) {
Text("下一页")
}
Button(onClick = {
nav.popBackStack()
}) {
Text("上一页")
}
}
}
@Composable
fun HomePage(nav: NavController, color:Color){
LaunchedEffect(Unit){
println("TEST HOMEPAGE START")
}
Column(modifier = Modifier.systemBarsPadding()) {
Button(onClick = {
nav.navigate("detail")
}) {
Text("go to detail", modifier = Modifier.height(50.dp).background(color=Color.Green))
}
LazyColumn(modifier = Modifier.fillMaxSize().background(color=Color.Blue)) {
items(200) { index ->
Text(" $index ", modifier = Modifier.height(50.dp))
Spacer(modifier = Modifier.height(20.dp))
}
}
}
}
@Composable
fun FavoritePage(nav:NavController){
LazyColumn(modifier = Modifier.fillMaxSize().background(color=Color.Green)) {
items(200) { index ->
Text(" $index ", modifier = Modifier.height(50.dp))
Spacer(modifier = Modifier.height(20.dp))
}
}
}
@Composable
fun MinePage(nav:NavController){
LazyColumn(modifier = Modifier.fillMaxSize().background(color=Color.Cyan)) {
items(200) { index ->
Text(" $index ", modifier = Modifier.height(50.dp))
Spacer(modifier = Modifier.height(20.dp))
}
}
}