SwiftUI中VoiceOver双击无障碍元素始终触发Button的问题

问题根源 #

你给Button添加的accessibilityHidden(true)仅会将其从无障碍访问树中隐藏，让VoiceOver忽略它，但Button本身的点击交互逻辑并未被禁用。所以当VoiceOver聚焦HStack并双击时，底层Button的点击事件依然会被触发。

解决方案一：禁用Button的交互能力 #

直接给Button添加.disabled(true)，彻底禁用其点击事件，配合accessibilityHidden(true)实现完全隔离：

struct ContentView: View {
    var body: some View {
        HStack(alignment: .top) {
            Button("one"){
                print("one selected")
            }
            .accessibilityHidden(true)
            .disabled(true) // 禁用Button交互
        }
        .accessibilityElement()
        .accessibilityAction(named: "Action One", {
            print("first actioned")
        })
        .accessibilityAction(named: "Action two", {
            print("Second actioned")
        })
    }
}

解决方案二：替换为非交互视图（如果不需要Button交互） #

如果只是需要Button的视觉样式，不需要其交互功能，直接用Text替代并模拟Button样式：

struct ContentView: View {
    var body: some View {
        HStack(alignment: .top) {
            Text("one")
                .foregroundColor(.accentColor) // 匹配系统Button文字颜色
                .padding(.horizontal, 16)
                .padding(.vertical, 8) // 模拟Button内边距
        }
        .accessibilityElement()
        .accessibilityAction(named: "Action One", {
            print("first actioned")
        })
        .accessibilityAction(named: "Action two", {
            print("Second actioned")
        })
    }
}

额外说明 #

当你将HStack标记为accessibilityElement()时，它会成为一个独立的无障碍容器，但容器内的可交互元素（比如未禁用的Button）依然会响应触摸事件。只有同时移除元素的交互能力，才能确保双击HStack时仅触发自定义的无障碍操作。

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