UIViewRepresentable按钮无法响应VoiceOver双击操作的原因？

问题分析 #

当前问题源于UIKit控件的无障碍属性与SwiftUI的无障碍配置冲突，叠加ScrollView的手势事件拦截，导致VoiceOver双击操作无法正确触发。

解决方案 #

1. 确保UIKit按钮本身的无障碍配置正确

在LargeButton的实现中明确设置无障碍属性，避免和SwiftUI的无障碍元素重叠：

class LargeButton: UIButton {
    override init(frame: CGRect) {
        super.init(frame: frame)
        setupAccessibility()
    }
    
    required init?(coder: NSCoder) {
        super.init(coder: coder)
        setupAccessibility()
    }
    
    private func setupAccessibility() {
        isAccessibilityElement = true
        accessibilityTraits = .button
        accessibilityLabel = "Confirm" // 匹配VoiceOver播报内容
    }
}

2. 调整UIViewRepresentable的交互传递

在SwiftUI封装层，通过Coordinator将UIKit按钮的点击事件传递给SwiftUI，同时避免冗余的无障碍配置：

struct SwiftUILargeButton: UIViewRepresentable {
    typealias UIViewType = LargeButton
    var action: () -> Void
    
    func makeUIView(context: Context) -> LargeButton {
        let button = LargeButton()
        button.addTarget(context.coordinator, action: #selector(Coordinator.buttonTapped), for: .touchUpInside)
        return button
    }
    
    func updateUIView(_ uiView: LargeButton, context: Context) {}
    
    func makeCoordinator() -> Coordinator {
        Coordinator(action: action)
    }
    
    class Coordinator: NSObject {
        let action: () -> Void
        
        init(action: @escaping () -> Void) {
            self.action = action
        }
        
        @objc func buttonTapped() {
            action()
        }
    }
}

3. 优化SwiftUI层级的手势与无障碍设置

修改视图结构，去掉冗余的accessibilityAction，确保按钮手势优先级高于ScrollView：

struct ConfirmButtonContainer: View {
    var action: () -> Void
    
    var body: some View {
        SwiftUILargeButton(action: action)
            .accessibilityHidden(true) // 让UIKit按钮作为唯一无障碍元素
    }
}

struct MyScreen: View {
    var body: some View {
        ZStack {
            ScrollView {
                // 滚动内容区域
            }
            .overlay(
                ConfirmButtonContainer(action: {
                    // 执行操作的代码
                })
                .highPriorityGesture(TapGesture()) // 确保按钮手势优先响应
                , alignment: .bottom
            )
        }
    }
}

4. 额外排查点

• 检查LargeButton是否有自定义手势识别器，若存在需确保不拦截VoiceOver的双击事件
• 确认ScrollView的contentInset未导致按钮触摸区域被遮挡

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