如何为带UITapGestureRecognizer的UIImageView配置无障碍点击动作描述？

核心问题排查 #

你遇到的问题根源在于两个关键细节：

• UIImageView默认isAccessibilityElement = false，VoiceOver不会将其识别为独立可访问元素，导致所有辅助属性设置失效
• UIAccessibilityCustomAction是用于给元素添加额外辅助操作（比如长按、滑动触发的动作），并非用来替代按钮主点击动作的播报逻辑

正确实现步骤 #

1. 标记视图为可访问元素
   必须先将UIImageView的isAccessibilityElement设为true，否则所有辅助属性都不会被VoiceOver识别：

   self.rightIcon.isAccessibilityElement = true
   

2. 设置标准辅助属性
   对于标记为.button的元素，用accessibilityLabel描述元素本身，accessibilityHint描述点击后的动作，这是VoiceOver的标准用法：

   // 初始化辅助属性基础设置
   self.rightIcon.accessibilityTraits = .button
   self.rightIcon.isAccessibilityElement = true
   
   // 设置元素名称和动作提示
   self.rightIcon.accessibilityLabel = "更多操作图标" // 替换为你的元素实际名称
   if let desc = model.rightIconActionDescription {
       self.rightIcon.accessibilityHint = desc // 比如"打开分享菜单"
   }
   

3. 确保手势与辅助功能兼容
   你的UITapGestureRecognizer无需特殊修改，只要保证没有设置isEnabled = false或其他阻止触发的逻辑即可。当VoiceOver用户双击该元素时，会自动触发手势绑定的executeAction方法，同时播报你设置的accessibilityLabel + accessibilityHint内容。

为什么之前的方法无效？ #

• accessibilityCustomActions：该属性用于给元素添加额外的辅助操作（比如一个按钮除了点击，还有“收藏”“删除”等长按触发的动作），主点击动作的播报不需要依赖它。
• accessibilityHint未生效：因为你没有设置isAccessibilityElement = true，VoiceOver根本没有识别这个视图，自然不会读取hint内容。

测试验证 #

运行后开启VoiceOver测试：

1. 聚焦到UIImageView时，会先播报accessibilityLabel，随后播报accessibilityHint
2. 双击时，会触发executeAction方法，同时VoiceOver会确认动作执行（播报内容基于你设置的hint生成）

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