使用CollapsingToolbar配合Navigation Component时如何自定义处理Navigation Up事件

问题根因 #

调用CollapsingToolbarLayout.setupWithNavController()时，方法内部会自动为绑定的Toolbar设置默认的导航按钮点击监听器，该监听器会直接调用NavController.navigateUp()处理返回，不会触发Activity的onSupportNavigateUp、onOptionsItemSelected等回调，因此原有基于这些方法的自定义逻辑就会失效。

正确实现方式 #

方案1：重写Toolbar导航点击事件（最灵活，推荐） #

在setupWithNavController执行完成后，手动为Toolbar重新设置导航点击监听器，在监听器中先执行自定义判断逻辑，再触发默认的导航操作：

// 原有初始化代码不变
layout.setupWithNavController(toolbar, navController, appBarConfiguration)

// 新增：重写导航按钮点击逻辑
toolbar.setNavigationOnClickListener {
    // 先执行自定义返回逻辑判断
    val currentFragment = navHostFragment.childFragmentManager.primaryNavigationFragment
    if (currentFragment is CustomInterceptFragment) {
        // 执行你的自定义操作，比如弹窗确认、保存数据等
        if (currentFragment.needInterceptBack()) {
            currentFragment.doCustomBackLogic()
            return@setNavigationOnClickListener
        }
    }
    // 自定义逻辑不需要拦截的话，走默认的导航返回逻辑
    navController.navigateUp(appBarConfiguration) || onSupportNavigateUp()
}

这个方案可以完全自定义导航按钮的处理逻辑，同时保留CollapsingToolbar自动从NavGraph读取标题的能力。

方案2：复用OnBackPressedCallback逻辑 #

如果你的自定义返回逻辑已经通过OnBackPressedDispatcher在Fragment中注册了回调，可以直接在导航点击事件中触发返回调度，统一处理硬件返回和NavUp按钮的逻辑：

toolbar.setNavigationOnClickListener {
    onBackPressedDispatcher.onBackPressed()
}

这种方式可以保证硬件返回键和NavUp按钮的逻辑完全一致，不需要写两套判断代码。

方案3：通过AppBarConfiguration配置全局fallback逻辑 #

如果你的自定义逻辑是全局的，可以直接修改初始化AppBarConfiguration时的fallbackOnNavigateUpListener参数：

appBarConfiguration = AppBarConfiguration(
    navGraph = navController.graph,
    fallbackOnNavigateUpListener = {
        // 当NavController无法处理返回操作时会触发该回调
        // 在这里写你的全局自定义返回逻辑
        // 返回true表示已经处理了返回事件，返回false表示继续执行默认逻辑
        if (/* 自定义拦截条件 */) {
            // 执行自定义操作
            true
        } else {
            finish()
            true
        }
    }
)

注意事项 #

• 不要同时调用setupActionBarWithNavController和CollapsingToolbarLayout.setupWithNavController，两者都会绑定Toolbar的导航逻辑，容易产生冲突。
• 如果你需要在不同Fragment实现不同的返回逻辑，推荐在Fragment中通过requireActivity().onBackPressedDispatcher.addCallback()注册OnBackPressedCallback，配合方案2使用即可实现NavUp和硬件返回的逻辑统一。

内容的提问来源于stack exchange，提问作者M.Baraka