Jetpack Compose Talkback场景下focusOrder自定义焦点顺序不生效问题咨询

问题原因 #

focusOrder 修饰符的作用范围仅限键盘、遥控器等D-pad方向导航场景，和无障碍服务（例如TalkBack）的线性焦点遍历是两套完全独立的逻辑，TalkBack不会读取focusOrder的配置，这是设置不生效的核心原因。

解决方法 #

1. 仅适配TalkBack遍历顺序 #

使用Modifier.semantics的traversalIndex属性控制无障碍遍历优先级，数值越小的组件越先被读取：

val focusRequesters = remember { List(4) { FocusRequester() } }
Column {
    Text("Line 1",
        Modifier
            .focusOrder(focusRequesters[0]) {
                next = focusRequesters[2]
                down = focusRequesters[2]
                right = focusRequesters[2]
            }
            .semantics { traversalIndex = 0f } // 第一个遍历
            .focusable())
    Text("Line 2",
        Modifier
            .focusOrder(focusRequesters[1]) {
                next = focusRequesters[0]
                down = focusRequesters[0]
                right = focusRequesters[0]
            }
            .semantics { traversalIndex = 3f } // 第四个遍历
            .focusable())
    Text("Line 3",
        Modifier
            .focusOrder(focusRequesters[2]) {
                next = focusRequesters[3]
                down = focusRequesters[3]
                right = focusRequesters[3]
            }
            .semantics { traversalIndex = 1f } // 第二个遍历
            .focusable())
    Text("Line 4",
        Modifier
            .focusOrder(focusRequesters[3]) {
                next = focusRequesters[1]
                down = focusRequesters[1]
                right = focusRequesters[1]
            }
            .semantics { traversalIndex = 2f } // 第三个遍历
            .focusable())
}

2. 同时兼容D-pad导航和TalkBack #

保留原有focusOrder配置，同时添加对应优先级的traversalIndex属性即可，两套配置分别负责两种场景的焦点逻辑。

注意事项 #

• traversalIndex属性需要Compose 1.2.0及以上版本支持，低于该版本需要先升级Compose依赖
• 跨父容器的遍历顺序优先判断父容器的traversalIndex，父容器优先级更高的话，其内部所有子组件的遍历顺序都会优先于低优先级父容器的子组件

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