SwiftUI Image的isAccessibilityElement为false，UI测试tap操作无效如何解决？

问题详情 #

我在SwiftUI应用里使用了带点击手势的Image，代码如下：

Image(systemName: "xmark.circle.fill")
    .accessibilityIdentifier(kTextFieldClearButton)
    .foregroundColor(.secondary)
    .padding(.trailing, 6)
    .onTapGesture {
        dataSource.textFieldText = ""
    }

在UI测试中，我尝试点击这个Image来执行清空操作，代码是：

let clearButton = app.images[kTextFieldClearButton]
clearButton.tap()

但操作并没有生效。我在clearButton.tap()处设置断点，用LLDB命令查看状态：

(lldb) p clearButton.isHittable
    t =   439.54s Find the "TextFieldClearButton" Image
(Bool) true

虽然输出格式有点奇怪，但这个Image确实是可点击的。再执行另一条命令：

(lldb) p clearButton.isAccessibilityElement
(Bool) false

我原本以为SwiftUI视图默认是可访问的，现在搞不懂为什么这个Image不是可访问元素。请问该怎么让它变成可访问元素，让clearButton.tap()按预期生效？

解决方法 #

方法一：手动添加无障碍特性 #

给Image添加.accessibilityAddTraits(.isButton)修饰符，明确标记它为可访问的按钮元素，还可以补充无障碍标签提升体验：

Image(systemName: "xmark.circle.fill")
    .accessibilityIdentifier(kTextFieldClearButton)
    .accessibilityLabel("清空输入框") // 可选，优化无障碍使用体验
    .accessibilityAddTraits(.isButton) // 关键：将视图标记为可交互的按钮元素
    .foregroundColor(.secondary)
    .padding(.trailing, 6)
    .onTapGesture {
        dataSource.textFieldText = ""
    }

方法二：包装成Button组件（更推荐） #

把Image包装成SwiftUI的Button组件，按钮本身默认就带有完整的无障碍支持，同时用PlainButtonStyle()保持原有外观：

Button(action: {
    dataSource.textFieldText = ""
}) {
    Image(systemName: "xmark.circle.fill")
        .accessibilityIdentifier(kTextFieldClearButton)
        .foregroundColor(.secondary)
        .padding(.trailing, 6)
}
.buttonStyle(PlainButtonStyle()) // 去除按钮默认样式，保留Image原本的外观

原因说明 #

SwiftUI的Image默认不属于可访问元素（isAccessibilityElement为false），哪怕给它加了点击手势，系统也不会自动把它识别成可交互的无障碍组件。通过上述两种方法，要么手动给Image添加按钮特性，要么直接用自带无障碍支持的Button组件，都能让UI测试正确识别并触发点击操作。

内容的提问来源于stack exchange，提问作者Reinhard Männer