原生移动开发 / 系统课时

底部导航与多入口页面

底部导航与多入口页面

这一节把多个一级页面接到同一个 NavigationBar,并让底部选中状态始终跟随真实导航目的地。重点不是画出三个按钮,而是避免重复入栈,同时在用户切换首页、搜索和我的页面时保存并恢复各入口的页面状态。

学习目标

  • 用 NavigationBar 和单个 NavController 管理多个一级入口
  • 从当前返回栈目的地计算底部导航的选中状态
  • 使用 saveState、restoreState 与 launchSingleTop 避免状态丢失和重复入栈

让导航栏只负责选择入口

底部导航不是三个互相独立的页面容器。常见做法是让 NavigationBar 和 NavHost 共享一个 NavController:导航栏发出“切到哪个一级目的地”的意图,真正显示哪个页面仍由返回栈决定。

底部导航切换一级页面并保存恢复状态的关系图

如果把选中的索引单独存成一个普通 remember 状态,它可能与返回栈脱节,例如系统返回键已经切换目的地,但底部仍高亮旧入口。更稳妥的做法是观察 currentBackStackEntryAsState(),由当前目的地反推哪个按钮应该选中。

准备导航依赖

下面是 app/build.gradle.kts 的片段示例。这里继续使用类型安全路由,因此需要 Navigation Compose 和 Kotlin Serialization。

kotlin
plugins {
    id("org.jetbrains.kotlin.plugin.serialization")
}

dependencies {
    implementation("androidx.navigation:navigation-compose:2.10.0")
    implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.7.3")
}

配置生效后,三个一级页面可以直接用可序列化对象作为路由,不需要维护 "home"、"search" 这类易拼错的字符串常量。

保存并恢复一级页面状态

下面的主示例为三个一级页面各放一个计数器。先在首页增加计数,再切到搜索,最后切回首页;如果导航选项正确,首页计数会保留。

kotlin
package com.example.bottomnavdemo

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.fillMaxSize
import androidx.compose.foundation.layout.padding
import androidx.compose.material3.Button
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.NavigationBar
import androidx.compose.material3.NavigationBarItem
import androidx.compose.material3.Scaffold
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableIntStateOf
import androidx.compose.runtime.saveable.rememberSaveable
import androidx.compose.runtime.setValue
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.navigation.NavDestination.Companion.hasRoute
import androidx.navigation.NavGraph.Companion.findStartDestination
import androidx.navigation.NavHostController
import androidx.navigation.NavOptionsBuilder
import androidx.navigation.compose.NavHost
import androidx.navigation.compose.composable
import androidx.navigation.compose.currentBackStackEntryAsState
import androidx.navigation.compose.rememberNavController
import kotlinx.serialization.Serializable

@Serializable
data object Home

@Serializable
data object Search

@Serializable
data object Profile

private enum class TopDestination(
    val label: String,
    val iconText: String
) {
    HOME("首页", "首"),
    SEARCH("搜索", "搜"),
    PROFILE("我的", "我")
}

class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContent {
            MaterialTheme {
                BottomNavApp()
            }
        }
    }
}

@Composable
private fun BottomNavApp() {
    val navController = rememberNavController()
    val backStackEntry by navController.currentBackStackEntryAsState()
    val currentDestination = backStackEntry?.destination

    Scaffold(
        bottomBar = {
            NavigationBar {
                TopDestination.entries.forEach { item ->
                    val selected = when (item) {
                        TopDestination.HOME ->
                            currentDestination?.hasRoute<Home>() == true
                        TopDestination.SEARCH ->
                            currentDestination?.hasRoute<Search>() == true
                        TopDestination.PROFILE ->
                            currentDestination?.hasRoute<Profile>() == true
                    }

                    NavigationBarItem(
                        selected = selected,
                        onClick = { navController.navigateTopLevel(item) },
                        icon = { Text(item.iconText) },
                        label = { Text(item.label) }
                    )
                }
            }
        }
    ) { innerPadding ->
        NavHost(
            navController = navController,
            startDestination = Home,
            modifier = Modifier.padding(innerPadding)
        ) {
            composable<Home> {
                CounterScreen("首页")
            }
            composable<Search> {
                CounterScreen("搜索")
            }
            composable<Profile> {
                CounterScreen("我的")
            }
        }
    }
}

private fun NavHostController.navigateTopLevel(item: TopDestination) {
    val options: NavOptionsBuilder.() -> Unit = {
        // 保存离开的一级目的地,并在回来时恢复。
        popUpTo(graph.findStartDestination().id) {
            saveState = true
        }
        launchSingleTop = true
        restoreState = true
    }

    when (item) {
        TopDestination.HOME -> navigate(Home, options)
        TopDestination.SEARCH -> navigate(Search, options)
        TopDestination.PROFILE -> navigate(Profile, options)
    }
}

@Composable
private fun CounterScreen(title: String) {
    var count by rememberSaveable { mutableIntStateOf(0) }

    Column(
        modifier = Modifier.fillMaxSize(),
        verticalArrangement = Arrangement.Center,
        horizontalAlignment = Alignment.CenterHorizontally
    ) {
        Text("$title:count=$count")
        Button(onClick = { count++ }) {
            Text("加一")
        }
    }
}

预期结果

text
启动:底部“首页”被选中,页面显示 首页:count=0
点击两次“加一”:首页显示 首页:count=2
切到“搜索”:底部“搜索”被选中,页面显示 搜索:count=0
再切回“首页”:底部“首页”重新被选中,页面仍显示 首页:count=2
连续点击已选中的“首页”不会不断创建重复的首页实例

这里 launchSingleTop 负责避免对当前一级目的地重复入栈;popUpTo(...){ saveState = true } 在切换入口时保存被弹出目的地的状态;restoreState = true 在再次进入时尝试恢复它。三者解决的是不同问题,不应只保留其中一个。

多入口继续扩展时的边界

如果某个一级入口内部还有“列表 → 详情 → 编辑”这样的二级页面,底部选中判断不能只比较一个叶子页面名称,而应判断当前目的地是否属于该一级入口对应的导航层级。此时通常把每个一级入口组织为嵌套导航图,再基于目的地层级判断选中状态。

当一级入口越来越多,或大屏设备需要更适合横向空间的导航方式时,可以把“目的地定义”和“导航逻辑”保留不变,只将 NavigationBar 替换为更合适的导航组件;这样页面状态和返回栈规则无需跟着 UI 外壳重写。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

底部导航与多入口页面

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通