Kotlin UI (六) Material3 Scaffold NavController

46 阅读2分钟

Material3

谷歌第三代质感设计系统,也是现在 Jetpack Compose 默认推荐的组件库。

M3 核心特点

  1. 动态配色(Material You 灵魂)  手机壁纸自动提取一套主题色,App 跟着系统颜色自动变,这是 M2 没有的特色。
  2. 圆角更大、风格柔和,组件视觉更现代,适配平板、折叠屏(自适应布局)
  3. 统一设计规范:内置一套标准颜色方案、字体排版、圆角、阴影、动效规范
  4. 组件齐全:Button / Card / TextField / Checkbox / Switch / AlertDialog / Scaffold / TopAppBar / NavigationBar 等开箱即用,不用自己画基础控件
  5. 内置动画规范,和 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

screen.png

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))
        }
    }
}