同一CustomView中UILabel的Accessibility VoiceOver在不同屏幕异常咨询

我之前碰到过几乎一模一样的场景——同一个自定义组件在不同页面表现不一致，VoiceOver突然失效，大多都是父视图的无障碍属性搞的鬼，咱们一步步来排查解决：

1. 重点检查中间容器的无障碍开关 #

先看屏幕2里的ContainerView和它下面的两层StackView：

• 有没有被设置了 accessibilityElementsHidden = true？这个属性会直接把自身和所有子元素的VoiceOver都隐藏掉，很容易误操作。
• 有没有把 isAccessibilityElement = true？如果某个父视图被标记为独立的可访问元素，默认情况下它的子元素会被VoiceOver忽略，除非你手动通过accessibilityElements把子元素加进去。

2. 确认CustomView自身的无障碍配置 #

检查你的CustomView：

• 别把它的isAccessibilityElement设为true！如果设了，VoiceOver会把整个CustomView当成一个单一的可访问单元，不会单独读取里面的UIImage和UILabel。如果需要把CustomView作为整体播报，那你得手动组合它的accessibilityLabel和accessibilityHint；如果要让子元素单独被访问，这个属性必须设为false。
• 再确认UILabel的isAccessibilityElement是true（默认就是），并且accessibilityLabel或者text有内容——空内容的label VoiceOver是不会读取的。

3. 用Accessibility Inspector直观排查 #

打开Xcode的Accessibility Inspector工具，对着屏幕2的UILabel点一下：

• 看看它有没有出现在无障碍元素列表里？如果没出现，说明被某个父视图给排除了。
• 检查它的无障碍属性是否正常，比如isAccessibilityElement是不是true，有没有被父视图的accessibilityElementsHidden影响。
  （操作路径：Xcode顶部菜单 → Xcode → Open Developer Tool → Accessibility Inspector）

4. 强制刷新无障碍队列 #

如果前面的检查都没问题，试试在CustomView添加到父视图后，发一个无障碍刷新通知：

UIAccessibility.post(notification: .layoutChanged, argument: yourCustomViewInstance)

有时候视图层级动态嵌套太深，VoiceOver没及时更新，这个通知能触发它重新扫描元素。

5. 检查StackView的默认设置 #

UIStackView默认是不会干扰子元素的无障碍的——它的isAccessibilityElement默认是false，会自动把子元素加入无障碍队列。但如果有人修改了它的accessibilityElements或者accessibilityElementsHidden，就会出问题，确认屏幕2里的那两个StackView都是默认配置。

我之前就是因为中间一个ContainerView被同事误设了accessibilityElementsHidden = true，导致子元素的VoiceOver全部失效，改回false就正常了，你按这个思路排查应该能解决问题。

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