Android TalkBack在CollapsingLayout中无法自动向下滚动如何解决

该问题的核心原因为：CollapsingToolbarLayout 和 AppBarLayout 默认未向 TalkBack 服务声明自身为可滚动容器，TalkBack 判定当前屏幕内容已完全展示，因此不会主动触发滚动动作加载隐藏内容。以下是三种可行的适配方案：

方案一：重写无障碍事件分发逻辑（通用稳定方案） #

• 核心思路：主动为CollapsingToolbarLayout配置无障碍代理，声明控件支持滚动动作，监听TalkBack的滚动指令主动调整AppBar的折叠状态

// 为CollapsingToolbarLayout设置无障碍滚动支持
collapsingToolbarLayout.accessibilityDelegate = object : View.AccessibilityDelegate() {
    override fun onInitializeAccessibilityNodeInfo(host: View, info: AccessibilityNodeInfo) {
        super.onInitializeAccessibilityNodeInfo(host, info)
        // 声明控件支持前后滚动动作
        info.addAction(AccessibilityNodeInfo.AccessibilityAction.ACTION_SCROLL_FORWARD)
        info.addAction(AccessibilityNodeInfo.AccessibilityAction.ACTION_SCROLL_BACKWARD)
        info.isScrollable = true
    }

    override fun performAccessibilityAction(host: View, action: Int, args: Bundle?): Boolean {
        val appBarLayout = host.parent as AppBarLayout
        when (action) {
            AccessibilityNodeInfo.ACTION_SCROLL_FORWARD -> {
                // 向前滚动，逐步折叠AppBar展示下方内容，步长可根据实际业务调整
                val behavior = (appBarLayout.layoutParams as CoordinatorLayout.LayoutParams).behavior as AppBarLayout.Behavior
                val currentOffset = behavior.topAndBottomOffset
                val targetOffset = (currentOffset - 200).coerceAtLeast(-appBarLayout.totalScrollRange)
                appBarLayout.setExpanded(targetOffset == 0, true)
                return true
            }
            AccessibilityNodeInfo.ACTION_SCROLL_BACKWARD -> {
                // 向后滚动，逐步展开AppBar展示上方内容
                val behavior = (appBarLayout.layoutParams as CoordinatorLayout.LayoutParams).behavior as AppBarLayout.Behavior
                val currentOffset = behavior.topAndBottomOffset
                val targetOffset = (currentOffset + 200).coerceAtMost(0)
                appBarLayout.setExpanded(targetOffset == 0, true)
                return true
            }
        }
        return super.performAccessibilityAction(host, action, args)
    }
}

方案二：监听无障碍焦点自动滚动（精准定位方案） #

• 核心思路：当TalkBack焦点落在折叠区域内不可见的元素上时，主动滚动AppBar将对应元素移动到可视区域

ViewCompat.setAccessibilityDelegate(collapsingToolbarLayout, object : AccessibilityDelegateCompat() {
    override fun onRequestSendAccessibilityEvent(host: ViewGroup, child: View, event: AccessibilityEvent): Boolean {
        if (event.eventType == AccessibilityEvent.TYPE_VIEW_ACCESSIBILITY_FOCUSED) {
            val visibleRect = Rect()
            // 判断当前获取焦点的View是否完全不可见
            val isFullyInvisible = !child.getLocalVisibleRect(visibleRect) || visibleRect.height() == 0
            if (isFullyInvisible) {
                val appBarLayout = host.parent as AppBarLayout
                // 滚动AppBar将对应View展示到屏幕
                appBarLayout.setExpanded(false, true)
                // 延迟后重新请求焦点，确保TalkBack可以正常朗读
                child.postDelayed({
                    child.performAccessibilityAction(AccessibilityNodeInfo.ACTION_ACCESSIBILITY_FOCUS, null)
                }, 300)
                return true
            }
        }
        return super.onRequestSendAccessibilityEvent(host, child, event)
    }
})

方案三：XML属性配置（轻量方案） #

针对内容结构简单的布局，不需要自定义逻辑的场景，可直接为CollapsingToolbarLayout添加如下属性即可适配大部分场景：

<com.google.android.material.appbar.CollapsingToolbarLayout
    android:id="@+id/collapsing_toolbar"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:scrollbars="vertical"
    android:importantForAccessibility="yes">
    <!-- 内部布局内容 -->
</com.google.android.material.appbar.CollapsingToolbarLayout>

注意：如果CollapsingToolbarLayout内部嵌套了NestedScrollView等可滚动容器，需要同步给嵌套的可滚动容器也配置上述无障碍属性，避免滚动冲突。
布局示意图：

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