如何为无障碍用户设置Android横向滑动（Fragment+JSON数据场景）

核心组件选择：ViewPager2 #

优先使用ViewPager2，它原生适配Android无障碍框架，支持TalkBack焦点遍历、手势识别及键盘导航，比自定义滑动View更省心，且能完美适配单Fragment复用加载动态JSON数据的场景。

具体实现步骤 #

1. 布局中添加ViewPager2 #

在你的Fragment布局文件里添加核心滑动容器：

<androidx.viewpager2.widget.ViewPager2
    android:id="@+id/stories_viewpager"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:importantForAccessibility="yes" />

2. 解析JSON数据并实现PagerAdapter #

假设你已将JSON解析为List<StoryItem>（包含每个Story的内容、描述等字段），创建FragmentStateAdapter复用同一个Fragment类加载不同数据：

// 数据实体类（根据你的JSON结构调整）
data class StoryItem(val id: String, val content: String, val description: String)

// Pager适配器
class StoriesPagerAdapter(fragment: Fragment, private val storyItems: List<StoryItem>) : FragmentStateAdapter(fragment) {
    override fun getItemCount() = storyItems.size

    override fun createFragment(position: Int): Fragment {
        // 复用同一个StoryFragment，传入对应位置的JSON数据
        return StoryFragment.newInstance(storyItems[position])
    }
}

// 可复用的StoryFragment
class StoryFragment : Fragment() {
    companion object {
        private const val ARG_STORY = "story_item"
        fun newInstance(item: StoryItem): StoryFragment = StoryFragment().apply {
            arguments = Bundle().apply { putParcelable(ARG_STORY, item) }
        }
    }

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)
        val storyItem = arguments?.getParcelable<StoryItem>(ARG_STORY) ?: return
        // 这里根据storyItem渲染页面UI（比如加载图片、文本等）
    }
}

3. 无障碍适配关键配置 #

在宿主Fragment的onViewCreated中完成ViewPager2的初始化及无障碍配置：

override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)
    val storyItems = parseJsonToStoryItems() // 你的JSON解析逻辑
    val viewPager = view.findViewById<ViewPager2>(R.id.stories_viewpager)
    viewPager.adapter = StoriesPagerAdapter(this, storyItems)

    // 基础无障碍配置
    viewPager.isFocusable = true
    viewPager.importantForAccessibility = View.IMPORTANT_FOR_ACCESSIBILITY_YES

    // 页面切换时更新无障碍描述，让TalkBack提示当前页面信息
    viewPager.registerOnPageChangeCallback(object : ViewPager2.OnPageChangeCallback() {
        override fun onPageSelected(position: Int) {
            super.onPageSelected(position)
            val currentStory = storyItems[position]
            viewPager.contentDescription = "第${position + 1}个故事，共${storyItems.size}个：${currentStory.description}"
        }
    })

    // 强化键盘导航支持（适配物理/屏幕键盘的左右键）
    viewPager.setOnKeyListener { _, keyCode, event ->
        if (event.action == KeyEvent.ACTION_DOWN) {
            when (keyCode) {
                KeyEvent.KEYCODE_DPAD_LEFT -> {
                    if (viewPager.currentItem > 0) {
                        viewPager.currentItem -= 1
                        true
                    } else false
                }
                KeyEvent.KEYCODE_DPAD_RIGHT -> {
                    if (viewPager.currentItem < storyItems.size - 1) {
                        viewPager.currentItem += 1
                        true
                    } else false
                }
                else -> false
            }
        } else false
    }
}

4. 单个Story页面的无障碍优化 #

在StoryFragment的UI渲染逻辑中，确保所有交互元素和内容都有合适的无障碍描述：

// 示例：为图片设置无障碍描述
storyImageView.contentDescription = storyItem.content
// 示例：为自定义按钮设置描述
actionButton.contentDescription = "查看故事详情"

5. 测试验证 #

• 开启系统TalkBack，测试左右滑动手势是否能切换页面，同时听到正确的页面提示
• 使用键盘左右箭头键验证页面切换功能
• 检查每个页面的所有内容是否能被无障碍服务正确读取

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