自定义按钮正常态图片被VoiceOver读出名称，如何禁用该朗读？

方法1：清空图片的无障碍标签 #

VoiceOver读取图片名称，是因为图片的accessibilityLabel默认沿用了文件名。直接给normal状态的图片设置空标签即可：

if let normalImage = UIImage(named: imageName1) {
    normalImage.accessibilityLabel = ""
    self.setImage(normalImage, for: .normal)
}
self.setImage(UIImage(named: imageName1), for: .selected)

这样既保留按钮的无障碍识别能力，又能阻止VoiceOver读取正常状态的图片名。

方法2：自定义按钮的无障碍属性 #

如果需要更精准地控制VoiceOver的朗读内容，可以直接设置按钮的无障碍标签和状态描述，覆盖图片的默认行为：

self.setImage(UIImage(named: imageName1), for: .normal)
self.setImage(UIImage(named: imageName1), for: .selected)

// 设置按钮的基础无障碍标签
self.accessibilityLabel = "自定义操作按钮"
// 标记按钮的无障碍特性
self.accessibilityTraits = .button
// 动态更新选中状态的朗读内容
self.accessibilityValue = isSelected ? "已选中" : "未选中"

这种方式能让VoiceOver更清晰地反馈按钮状态，提升整体无障碍体验。

方法3：结合图片渲染模式优化（可选） #

如果你的图片是作为按钮图标使用，可以将其设置为模板渲染模式，配合前两种方法效果更佳：

if let normalImage = UIImage(named: imageName1)?.withRenderingMode(.alwaysTemplate) {
    normalImage.accessibilityLabel = ""
    self.setImage(normalImage, for: .normal)
}
self.setImage(UIImage(named: imageName1)?.withRenderingMode(.alwaysTemplate), for: .selected)

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