Android Jetpack Compose中HorizontalPager无障碍焦点序列异常问题

1. 为Pager条目绑定明确的无障碍语义 #

每个Pager条目需要通过semantics修饰符指定无障碍角色，并关联页面索引，让无障碍服务能正确识别条目归属：

HorizontalPager(state = pagerState) { page ->
    YourItemView(pageData = data[page])
        .semantics {
            role = Role.ListItem
            pageIndex = page
        }
}

2. 滚动完成后同步焦点与无障碍状态 #

使用focusRequester时，必须等待页面滚动动画结束后再请求焦点，同时通知无障碍服务更新状态，修改你的点击事件逻辑：

val requester = FocusRequester()

onItemClicked = { targetPage ->
    coroutineScope.launch {
        // 等待滚动动画完全结束
        pagerState.animateScrollToPage(targetPage).join()
        // 请求当前页面条目的焦点
        requester.requestFocus()
        // 通知无障碍服务刷新焦点状态
        ViewCompat.notifyEnterOrExitForAccessibility(localContext.current as View)
    }
}

// 在Pager条目上绑定焦点请求器
HorizontalPager(state = pagerState) { page ->
    YourItemView(pageData = data[page])
        .focusRequester(requester)
        .focusable(true)
        .semantics {
            role = Role.ListItem
            pageIndex = page
        }
}

3. 配置Pager本身的无障碍属性 #

给HorizontalPager添加semantics修饰符，明确其滚动容器的角色，帮助无障碍服务理解组件结构：

HorizontalPager(state = pagerState) { page ->
    // ...条目内容
}
.semantics {
    role = Role.Scrollable
    scrollRange = pagerState.pageCount
}

4. 排查条目内部的焦点抢占问题 #

如果条目包含可聚焦子View（如按钮、输入框），需通过语义配置确保条目本身成为无障碍焦点目标：

YourItemView(...)
    .focusRequester(requester)
    .focusable(true)
    .semantics {
        isTraversalGroup = true // 将条目标记为独立的焦点遍历组
    }

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