二次导航后TalkBack无法聚焦新Fragment的技术问题

问题核心 #

采用单Activity多Fragment架构，经过Fragment A返回LoadingFragment后，自动导航到Fragment B时，无障碍焦点停留在LoadingFragment，Fragment B的文本无法被朗读。手动触发导航（按钮点击）正常，自动延迟导航出现问题，原因是自动导航没有触发无障碍框架的焦点刷新机制，且LoadingFragment的视图仍被无障碍框架视为活跃状态。

解决方案 #

1. 标记LoadingFragment视图为无障碍不可用 #

在LoadingFragment执行导航前，主动标记自身根视图为无障碍不可用，避免其继续占用焦点：

class LoadingFragment : Fragment() {

    private lateinit var rootView: View
    private var navigateHandler: Handler? = null
    private var navigateRunnable: Runnable? = null

    override fun onCreateView(
        inflater: LayoutInflater,
        container: ViewGroup?,
        savedInstanceState: Bundle?
    ): View = inflater.inflate(R.layout.fragment_main, container, false).also {
        rootView = it
    }

    private var beenHereBefore = false

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)
        navigateRunnable = Runnable {
            // 导航前禁用当前视图的无障碍可用性
            rootView.importantForAccessibility = View.IMPORTANT_FOR_ACCESSIBILITY_NO_HIDE_DESCENDANTS
            findNavController().navigate(
                if (beenHereBefore) {
                    R.id.action_mainFragment_to_fragmentB
                } else {
                    beenHereBefore = true
                    R.id.action_mainFragment_to_fragmentA
                }
            )
        }
        navigateHandler = Handler(Looper.getMainLooper()).apply {
            postDelayed(navigateRunnable!!, 5000)
        }
    }

    override fun onDestroyView() {
        super.onDestroyView()
        // 清理延迟任务，防止内存泄漏和无效导航
        navigateHandler?.removeCallbacks(navigateRunnable!!)
        navigateHandler = null
        navigateRunnable = null
    }
}

2. 确保Fragment B视图绘制完成后请求焦点 #

Fragment B的视图需要在完全绘制后主动请求焦点，并通知无障碍服务：

class FragmentB : Fragment() {

    override fun onCreateView(
        inflater: LayoutInflater,
        container: ViewGroup?,
        savedInstanceState: Bundle?
    ): View = inflater.inflate(R.layout.fragment_b, container, false)

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)
        val textView = view.findViewById<TextView>(R.id.textView2)
        
        // 等待视图绘制完成后执行焦点请求
        textView.viewTreeObserver.addOnGlobalLayoutListener(object : ViewTreeObserver.OnGlobalLayoutListener {
            override fun onGlobalLayout() {
                // 移除监听避免重复执行
                textView.viewTreeObserver.removeOnGlobalLayoutListener(this)
                
                // 设置视图可获取焦点
                textView.isFocusable = true
                textView.isFocusableInTouchMode = true
                
                // 请求焦点并通知无障碍服务
                textView.requestFocus()
                ViewCompat.sendAccessibilityEvent(
                    textView,
                    AccessibilityEvent.TYPE_VIEW_FOCUSED
                )
            }
        })
    }
}

3. 优化导航栈（可选） #

如果LoadingFragment不需要保留在导航栈中，可以在导航到Fragment B的action中设置app:popUpTo="@id/mainFragment"和app:popUpToInclusive="true"，彻底移除LoadingFragment的实例，避免其干扰焦点：

修改main_graph.xml中的action：

<action
    android:id="@+id/action_mainFragment_to_fragmentB"
    app:destination="@id/fragmentB"
    app:popUpTo="@id/mainFragment"
    app:popUpToInclusive="true" />

原理说明 #

• 手动按钮触发导航时，系统会自动触发无障碍框架的焦点刷新；而延迟自动导航没有这个触发机制，需要手动干预。
• 标记LoadingFragment视图为无障碍不可用，能让无障碍框架忽略它，避免焦点残留。
• 等待Fragment B视图绘制完成后请求焦点，确保视图已经完全加载，避免请求焦点时视图还未初始化。

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