AndroidX中不同Fragment间视图交互的最佳实践

问题描述 #

假设有两个Fragment：一个包含WebView的BrowserFragment，一个包含书签列表及添加新书签按钮的BookmarksFragment。点击添加书签按钮时，需要调用BrowserFragment中WebView的getUrl方法并将结果传回BookmarksFragment；点击列表中的书签时，需要调用WebView的loadUrl方法。在AndroidX中实现该需求的最佳实践是什么？我查阅了《Fragments Communication Guide》，但认为无法通过ViewModel实现。我知道可以使用fragmentManager.setFragmentResult和setFragmentResultListener，但不确定这是否为最优方案；也可以通过findFragmentByTag获取BrowserFragment，但据我所知这是不良实践，对吗？

针对这个场景，下面是几种规范且高效的实现方式，按推荐优先级排序：

1. FragmentResultAPI（官方推荐的最优方案） #

这是AndroidX官方主推的Fragment间通信方式，完全遵循组件解耦原则，不需要直接持有另一个Fragment的引用，完美适配你的请求-响应式通信场景。

实现步骤： #

• BookmarksFragment触发获取URL请求：

  // BookmarksFragment.kt
  addBookmarkButton.setOnClickListener {
      // 发送请求标记，无需携带参数
      parentFragmentManager.setFragmentResult("REQUEST_GET_CURRENT_URL", Bundle())
  }
  

• BrowserFragment监听请求并返回结果：

  // BrowserFragment.kt
  override fun onCreate(savedInstanceState: Bundle?) {
      super.onCreate(savedInstanceState)
      parentFragmentManager.setFragmentResultListener("REQUEST_GET_CURRENT_URL", this) { _, _ ->
          val currentUrl = webView.url
          // 回传当前URL结果
          parentFragmentManager.setFragmentResult("RESULT_CURRENT_URL", Bundle().apply {
              putString("url", currentUrl)
          })
      }
  }
  

• BookmarksFragment接收URL并添加书签：

  // BookmarksFragment.kt
  override fun onCreate(savedInstanceState: Bundle?) {
      super.onCreate(savedInstanceState)
      parentFragmentManager.setFragmentResultListener("RESULT_CURRENT_URL", this) { _, bundle ->
          val url = bundle.getString("url")
          url?.let {
              // 执行添加书签的业务逻辑
          }
      }
  }
  

• 书签点击触发URL加载：

  // BookmarksFragment.kt
  bookmarkList.setOnItemClickListener { _, _, position, _ ->
      val targetUrl = bookmarkList[position].url
      parentFragmentManager.setFragmentResult("REQUEST_LOAD_URL", Bundle().apply {
          putString("target_url", targetUrl)
      })
  }
  
  // BrowserFragment.kt
  parentFragmentManager.setFragmentResultListener("REQUEST_LOAD_URL", this) { _, bundle ->
      val targetUrl = bundle.getString("target_url")
      targetUrl?.let { webView.loadUrl(it) }
  }
  

2. 共享ViewModel（可行方案，纠正你的误解） #

你之前认为ViewModel无法实现是个误区，通过共享Activity作用域的ViewModel，完全可以实现跨Fragment的事件传递与状态共享，适合需要长期维护共享状态的场景。

实现步骤： #

• 创建共享ViewModel：

  class BrowserSharedViewModel : ViewModel() {
      // 触发获取当前URL的事件
      val fetchCurrentUrl = MutableLiveData<Unit>()
      // 存储当前URL的结果
      val currentUrl = MutableLiveData<String?>()
      // 触发加载指定URL的事件
      val loadTargetUrl = MutableLiveData<String?>()
  }
  

• BrowserFragment处理事件：

  // BrowserFragment.kt
  private val sharedViewModel: BrowserSharedViewModel by activityViewModels()
  
  override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
      super.onViewCreated(view, savedInstanceState)
      // 监听获取URL的请求
      sharedViewModel.fetchCurrentUrl.observe(viewLifecycleOwner) {
          sharedViewModel.currentUrl.value = webView.url
      }
      // 监听加载URL的请求
      sharedViewModel.loadTargetUrl.observe(viewLifecycleOwner) { url ->
          url?.let { webView.loadUrl(it) }
      }
  }
  

• BookmarksFragment触发事件并接收结果：

  // BookmarksFragment.kt
  private val sharedViewModel: BrowserSharedViewModel by activityViewModels()
  
  override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
      super.onViewCreated(view, savedInstanceState)
      // 点击添加书签，触发URL获取
      addBookmarkButton.setOnClickListener {
          sharedViewModel.fetchCurrentUrl.value = Unit
      }
      // 接收返回的URL并添加书签
      sharedViewModel.currentUrl.observe(viewLifecycleOwner) { url ->
          url?.let {
              // 执行添加书签逻辑
          }
      }
      // 点击书签，触发URL加载
      bookmarkList.setOnItemClickListener { _, _, position, _ ->
          val targetUrl = bookmarkList[position].url
          sharedViewModel.loadTargetUrl.value = targetUrl
      }
  }
  

3. 绝对不推荐：findFragmentByTag获取Fragment引用 #

直接通过findFragmentByTag获取另一个Fragment的引用属于严重的不良实践，会让两个Fragment产生强耦合：一旦Fragment的标签、实例状态发生变化，极易出现空指针或逻辑异常；同时完全违背了组件化的设计思想，后续代码维护成本极高，绝对不建议使用。

总结：FragmentResultAPI是当前场景的最优选择，它既保证了Fragment的解耦，又能高效完成单向的请求-响应式通信；如果你的项目已经在使用共享ViewModel管理跨组件状态，那么用ViewModel实现也是完全可行的。

内容的提问来源于stack exchange，提问作者nhcodes