SwiftUI中.accessibilityLabeledPair(role:id:in:)使用问题求助

你对accessibilityLabeledPair的作用理解有偏差——这个API的核心是建立标签和控件的语义关联，而不是将两者合并为一个可聚焦元素。WWDC里提到的“关联”是指让辅助技术（比如VoiceOver）知道这两个元素属于同一组，而非合并焦点。

为什么你的代码没达到预期？ #

accessibilityLabeledPair只会在VoiceOver聚焦控件时，额外关联读出标签文本，但不会让文本和按钮共享同一个焦点。所以你会看到两者仍然被分别聚焦。

正确实现“合并焦点+标签关联”的方法 #

如果想要让VoiceOver将文本和按钮视为一个焦点，同时用文本作为无障碍标签，推荐以下两种方式：

方法1：给按钮设置无障碍标签，隐藏文本的可访问性

直接把文本内容设为按钮的accessibilityLabel，同时将文本视图标记为不可访问：

import SwiftUI

struct ContentView: View {
    @State private var isOn = false

    var body: some View {
        HStack {
            Text("I agree on the terms and conditions")
                .accessibilityHidden(true) // 让文本不被VoiceOver单独聚焦
            Button {
                isOn = !isOn
            } label: {
                isOn ? Image(systemName: "checkmark.circle.fill") : Image(systemName: "circle")
            }
            .accessibilityLabel("I agree on the terms and conditions") // 给按钮设置标签
        }
    }
}

方法2：合并元素为单个无障碍元素

用accessibilityElement(children: .combine)将HStack内的元素合并为一个可聚焦元素，再统一设置标签：

import SwiftUI

struct ContentView: View {
    @State private var isOn = false

    var body: some View {
        HStack {
            Text("I agree on the terms and conditions")
            Button {
                isOn = !isOn
            } label: {
                isOn ? Image(systemName: "checkmark.circle.fill") : Image(systemName: "circle")
            }
        }
        .accessibilityElement(children: .combine) // 合并子元素为单个无障碍元素
        .accessibilityLabel("I agree on the terms and conditions")
        .accessibilityAddTraits(isOn ? .isSelected : []) // 可选：添加选中状态的提示
    }
}

accessibilityLabeledPair的正确使用场景 #

这个API适合标签和控件必须分开布局，且需要保持各自可聚焦性，但要让辅助技术知道两者关联的场景。比如表单中的标签和输入框：当VoiceOver聚焦输入框时，会自动读出关联的标签文本，但标签本身依然可以被单独聚焦。

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