Jetpack Compose中如何修改Talkback初始无障碍焦点

针对你遇到的初始无障碍焦点停留在导航图标、FocusRequester失效的问题，这里提供两种可行的解决方案：

方案一：优化FocusRequester配合无障碍事件发送 #

FocusRequester失效通常是因为请求时机过早（组件未完成布局）或未正确关联无障碍语义。调整后的实现如下：

@Composable
fun TargetScreen() {
    val buttonFocusRequester = remember { FocusRequester() }
    val localView = LocalView.current

    Surface {
        // 顶部导航栏
        TopToolbarBar {
            Row {
                NavigationIcon()
                Title()
                // 其他组件
            }
        }

        Card1 {
            Row1()
            Column {
                RowA()
                RowB()
                // 目标按钮
                Button(
                    onClick = { /* 点击逻辑 */ },
                    modifier = Modifier
                        .focusRequester(buttonFocusRequester)
                        .focusable()
                        .semantics {
                            isFocusable = true // 明确标记为可聚焦的无障碍元素
                        }
                ) {
                    Text("操作按钮")
                }
            }
        }

        Card2 { /* 其他内容 */ }
    }

    LaunchedEffect(Unit) {
        // 等待一帧确保组件布局完成后再请求焦点
        withFrameNanos {
            val focusSuccess = buttonFocusRequester.requestFocus()
            if (focusSuccess) {
                // 发送无障碍焦点事件，对应XML的sendAccessibilityEvent(TYPE_VIEW_FOCUSED)
                localView.sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_FOCUSED)
            }
        }
    }
}

方案二：直接操作语义节点触发无障碍焦点 #

利用Compose的语义系统，直接定位目标Button的语义节点并请求焦点，适合更复杂的布局场景：

@Composable
fun TargetScreen() {
    val semanticsOwner = remember { mutableStateOf<SemanticsOwner?>(null) }
    val buttonSemanticsKey = remember { UniqueKey() }
    val localView = LocalView.current

    Surface(
        modifier = Modifier.onGloballyPositioned { coords ->
            // 获取全局语义所有者
            semanticsOwner.value = coords.semanticsOwner
        }
    ) {
        // 页面结构...
        Card1 {
            Row1()
            Column {
                RowA()
                RowB()
                Button(
                    onClick = { /* 点击逻辑 */ },
                    modifier = Modifier.semantics(key = buttonSemanticsKey) {
                        // 给按钮标记唯一语义key，用于定位
                    }
                ) {
                    Text("操作按钮")
                }
            }
        }
    }

    LaunchedEffect(semanticsOwner.value) {
        semanticsOwner.value?.let { owner ->
            // 请求语义节点获取焦点
            owner.sendSemanticsEvent(buttonSemanticsKey, SemanticsActions.RequestFocus)
            // 发送无障碍焦点事件
            localView.sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_FOCUSED)
        }
    }
}

额外注意事项 #

• 确保Talkback处于开启状态，否则焦点请求不会触发无障碍焦点切换
• 如果导航图标默认抢占焦点，可临时给它的Modifier添加clearAndSetSemantics { isFocusable = false }（需确认业务允许禁用其焦点）
• 避免同时给多个组件设置初始焦点请求，确保只有目标Button执行相关逻辑

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