iOS Accessibility--VoiceOver

我们可以简单把Accessibility理解成无障碍化使用，这个“无障碍”面向群体是视障人士
在iOS中，Accessibility主要分为三部分

VoiceOver，旁白读屏

Zoom，缩放

White on Black，反转颜色
这里主要介绍VoiceOver

什么是VoiceOver

VoiceOver是苹果手机上一个给视力不好或者盲人使用应用程序的语音辅助软件，即使你看不见也不成问题。轻触屏幕即可听到你手指划过的内容，然后运用手势来控制设备。VoiceOver 支持 iPhone、iPad 或 iPod touch 所配备的 app。

如何打开VoiceOver

手机设备
设置(Setting)→辅助功能(Accessibility)→旁白(VoiceOver)
- 轻点一下选择控件
- 轻点两下激活所选控件
- 三指轻扫滚动视图
模拟器
打开Accessibility Inspector进行调试
Xcode→Open Developer Tool→Accessibility Inspector

如何支持VoiceOver

VoiceOver并不是万能的，并不能兼容开发者自定义的控件和视图，因此作为开发者，需要通过一些额外的工作让 APP 可以支持无障碍使用。
所有的标准 UIKit 控件和视图默认支持 VoiceOver，当然你也可以通过UIAccessibility 编程接口关闭或者修改。
如果App使用了用户自定义的一些控件，这时候就需要用户通过 UIAccessibility编程接口来支持无障碍

什么是AccessibilityElement
VoiceOver是通过访问元素达到无障碍使用的，能被VoiceOver访问的元素叫做AccessibilityElement，UIKit中的基本控件都支持VoiceOver
UILabel，UIButton这些控件的isAccessibilityElement属性默认就是true，UIView这个属性默认是false
AccessibilityElement的应用
一般的AccessibilityElement系统会自动读出它的内容，所以很多情况下不需要做特殊处理应用也会支持VoiceOver，但如果需要读出其他自定义内容就需要了解一下几个属性
- accessibilityLabel：用于描述内容“是什么”
- accessibilityHint：用于描述行动“做什么”
- accessibilityValue：用于描述“值是多少”
- accessibilityTraits：一个或多个独立特征的组合

读的顺序accessibilityLabel→accessibilityValue→accessibilityTraits→accessibilityHint

let count = 2
addButton.accessibilityLabel = "Add count"
addButton.accessibilityHint = "tap to add count"
addButton.accessibilityValue = "\(count)"
addButton.accessibilityTraits = [.button]
// 如果是单一的控件，可以不用设置accessibilityTraits，系统会自动识别

这段代码读的顺序：Add count(accessibilityLabel) 2(accessibilityValue) button(accessibilityTraits) tap to add count(accessibilityHint)

自定义视图如何支持VoiceOver
在前面我们有提到View的isAccessibilityElement属性默认为false，所以第一步我们需要开启isAccessibilityElement，使得VoiceOver可以访问这个View
UIAccessibilityCustomAction
一个 UIAccessibilityCustomAction 对象代表一个在无障碍对象上执行的自定
义操作

  let save = UIAccessibilityCustomAction(name: "save the custom view",
                                                 target: self,
                                                 selector: #selector(tappedSave))
  accessibilityCustomActions = [save]

UIAccessibilityPostNotification
Accessibility提供了一些列的通知来完成特殊的需求

public static func post(notification: UIAccessibility.Notification, argument: Any?)

例如在App中存在错误有弹窗弹出覆盖屏幕的主要部分，在弹窗弹出后，通过调用这个方法，将焦点聚焦到弹窗标题上

UIAccessibility.post(notification: .screenChanged, argument: nil)

实际应用

假设现在有一个UITableview与一个自定义Cell，Cell中有一个按钮，现在需求是可以访问Cell与Cell中的按钮，且分别读出不同的内容，那么我们要怎么实现这个需求呢
我们首先回想一下前面提到的，当一个View（或子类）激活isAccessibilityElement时，它的子视图都变为不可访问了，所以单纯设置Cell为访问元素然后再访问子元素这个思路是行不通的

方案一
我们可以这么做，Cell不激活为isAccessibilityElement，但是苹果内部是可以将Cell作为整一个访问元素且设置它的accessibilityLabel，完成button基本设置后，再设置button的accessibilityHint就可以实现我们想要的效果

private func setupAccessibility() {
        accessibilityLabel = "cell"
        nameLabel.accessibilityLabel = nameLabel.text
        nameLabel.isAccessibilityElement = true
        logoView.isAccessibilityElement = true
        logoView.accessibilityLabel = "logo"
        button.accessibilityHint = "save the info"
    }

方案二
我们可以激活Cell为isAccessibilityElement，然后对其添加accessibilityCustomActions绑定对应的方法，这个方案，nameLabel、logoView、button 虽然已经激活为isAccessibilityElement，但依然是无法访问的，所以你是看不到访问的框去到button或者其他控件那里的

private func setupAccessibility() {
        isAccessibilityElement = true
        accessibilityLabel = "cell"
        nameLabel.accessibilityLabel = nameLabel.text
        nameLabel.isAccessibilityElement = true
        logoView.isAccessibilityElement = true
        logoView.accessibilityLabel = "logo"
        button.isAccessibilityElement = true
        button.accessibilityHint = "save the info"

        let action = UIAccessibilityCustomAction(name: "action", target: self, selector: #selector(didTapButton))
        accessibilityCustomActions = [action]
    }

Tips

经试验，accessibilityHint只有在真机的情况下才会读出来，而且与上一个属性之间间隔大概有1秒的时间，debug的时候要留意
当这整个View作为VoiceOver的访问元素，View中的subview都会变为不可访问，如果需要都支持VoiceOver，需要改变他们的层级关系，且都开启isAccessibilityElement
UIAccessibilityCustomAction触发条件在Voice Over的情况下，选中到该元素后，通过上划或者下划来选择需要触发的事件

参考文档
Accessibility Programming Guide for iOS
iOS Accessibility Tutorial: Getting Started
Making Apps More Accessible With Custom Actions