Kotlin中Fragment向Tab页传递数据的实现方法

你给Tab绑定的Fragment传Safe Args失败，核心原因是Tab页Fragment由Tab宿主容器（ViewPager2/内部NavHostFragment）托管，不是菜单Fragment导航动作的直接目的地，Safe Args不会自动把参数注入到这些内部管理的子Fragment里。下面给两种经过生产验证的实现方式，都兼容你现有的Safe Args传值逻辑。

这个方案数据一致性最好，支持数据变更自动通知所有Tab页，生命周期安全无泄漏，是Jetpack架构下的标准实现。

• 第一步：定义共享ViewModel，用SavedStateHandle支持系统杀进程后数据自动恢复

class TabSharedViewModel(savedStateHandle: SavedStateHandle) : ViewModel() {
    companion object {
        private const val KEY_INT_PARAM = "key_int_param"
        private const val KEY_STR_PARAM = "key_str_param"
    }

    private val intFlow = savedStateHandle.getStateFlow(KEY_INT_PARAM, 0)
    private val strFlow = savedStateHandle.getStateFlow(KEY_STR_PARAM, "")

    fun setParams(intValue: Int, strValue: String) {
        savedStateHandle[KEY_INT_PARAM] = intValue
        savedStateHandle[KEY_STR_PARAM] = strValue
    }

    fun observeIntParam(): Flow<Int> = intFlow
    fun observeStrParam(): Flow<String> = strFlow
}

• 第二步：Tab宿主Fragment接收菜单Fragment传来的Safe Args参数，存入共享ViewModel
  你之前给普通Fragment传值的Safe Args逻辑完全不用改，导航到Tab宿主页时正常传int和string参数即可，在宿主页接收参数后存入ViewModel：

// Tab宿主Fragment代码
override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)
    // 接收Safe Args参数，写法和你之前给普通Fragment传值完全一致
    val args by navArgs<TabHostFragmentArgs>()
    val targetInt = args.passInt
    val targetStr = args.passStr

    // *注意：ViewModel作用域绑定当前宿主Fragment，不要绑定Activity，避免数据串页*
    val sharedViewModel: TabSharedViewModel by viewModels(ownerProducer = { this })
    sharedViewModel.setParams(targetInt, targetStr)

    // 后续正常初始化ViewPager2、TabLayout和Tab适配器即可
}

• 第三步：两个Tab子Fragment统一从宿主Fragment作用域获取ViewModel读数据
  两个Tab页不需要单独配置Safe Args参数，直接拿同一个ViewModel实例即可：

// 任意Tab子Fragment代码
override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)
    // 作用域指定为父宿主Fragment，和存数据的作用域保持一致
    val sharedViewModel: TabSharedViewModel by viewModels(ownerProducer = { requireParentFragment() })

    // 生命周期安全的方式监听数据，页面退到后台自动停止收集，避免内存泄漏
    viewLifecycleOwner.lifecycleScope.launch {
        repeatOnLifecycle(Lifecycle.State.STARTED) {
            launch {
                sharedViewModel.observeIntParam().collect { intValue ->
                    // 拿到整型值更新UI
                }
            }
            launch {
                sharedViewModel.observeStrParam().collect { strValue ->
                    // 拿到字符串值更新UI
                }
            }
        }
    }
}

如果页面逻辑简单，不想额外定义ViewModel，可以用AndroidX提供的跨Fragment传值API，不需要改动导航图配置：

• 第一步：Tab宿主Fragment收到Safe Args参数后，通过childFragmentManager分发结果

// Tab宿主Fragment代码
override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)
    val args by navArgs<TabHostFragmentArgs>()
    val paramBundle = bundleOf(
        "extra_int" to args.passInt,
        "extra_str" to args.passStr
    )
    // 向所有子Fragment广播参数
    childFragmentManager.setFragmentResult("tab_common_params", paramBundle)
}

• 第二步：两个Tab子Fragment注册结果监听，拿到参数

// 任意Tab子Fragment代码
override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)
    requireParentFragment().childFragmentManager.setFragmentResultListener(
        "tab_common_params",
        viewLifecycleOwner
    ) { _, resultBundle ->
        val intValue = resultBundle.getInt("extra_int")
        val strValue = resultBundle.getString("extra_str", "")
        // 直接使用拿到的两个参数即可
    }
}

• 不要尝试直接给Tab子Fragment配置Safe Args参数并手动导航传值：Tab页Fragment是容器自动创建的，手动调用导航动作会打乱Fragment返回栈，导致页面重复创建、返回逻辑错乱
• 不要把共享ViewModel绑定到Activity作用域：Activity作用域的ViewModel生命周期和整个App一致，退出Tab页后数据不会清空，后续其他页面如果获取同类型ViewModel会拿到脏数据
• 如果用NavigationUI绑定多Tab导航，不要在导航图里给Tab子Fragment配置全局静态参数，会覆盖你动态传递的业务值

内容的提问来源于stack exchange，提问作者Coding An App