
VoiceOver 是蘋果「讀屏」技術的名字,屬於輔助功能的一環。它會把螢幕上的資訊朗讀出來,讓視障使用者得以完成人機互動。這套技術貫穿蘋果各個系統——OS X、iOS、watchOS 乃至 tvOS。蘋果的 VoiceOver 曾在 2015 年 6 月 18 日獲得美國盲人基金會(AFB)頒發的海倫凱勒成就獎,是全球第一家拿下這項殊榮的科技公司。單就 iOS 而言,VoiceOver 的完成度在三大行動平台中可說是最好的。
雖然系統預設的 UI 組件基本都已支援 VoiceOver,但多數 App 仍需要針對它做適配與優化,尤其是自訂的複雜組件。
iPhone 開啟 VoiceOver 後,用單指左右輕掃即可遍歷當前畫面所有可存取的 AccessibilityElement;某個元素被選中時,VoiceOver 會把它的資訊讀出來。單指輕點兩下則能觸發該元素對應的操作——若它是按鈕,觸發的就是按鈕的 Action。
換句話說,開發時我們要關注四件事:
畫面上有哪些 AccessibilityElement
這些元素的位置與形狀
元素被選中時要讀出什麼資訊
元素能回應哪些事件
UIKit 的控件基本上都已 VoiceOver Ready,即使是 UIView,只要設定得當也能變成 AccessibilityElement。因此下面談到的 AccessibilityElement,指的都是 UIView 或其子類的實例,相關屬性與方法大多宣告在 UIAccessibility.h 裡。
最簡單的情況,用 UIView 的 isAccessibilityElement 就能控制某個 View 是否可被存取。UIKit 中 UILabel、UIButton 這類控件的這個屬性預設是 true,而 UIView 預設是 false。
位置與形狀一般由 accessibilityFrame 決定,預設值是該 View 在螢幕上的位置,形狀則是它的矩形輪廓。若要自行設定,注意這裡的 frame 是相對於螢幕座標系的,可以借助 UIAccessibilityConvertFrameToScreenCoordinates 來換算。這個函數有兩個參數:一個 rect、一個 view,作用是把手機座標系下的 rect 轉成螢幕座標系並回傳。所以一般傳入的 rect 是目標元素在父 View 中的 frame,view 則是它的父 View。
public func UIAccessibilityConvertFrameToScreenCoordinates(rect: CGRect, _ view: UIView) -> CGRect
若需要非矩形的形狀,可以給 accessibilityPath 指定一個 UIBezierPath 來自訂輪廓。
至于要讀出的資訊,由下面幾個屬性決定:
accessibilityLabel:這是什麼
accessibilityHint:有什麼用、會產生什麼結果
accessibilityValue:它的值是什麼
accessibilityTraits:類型與狀態,用枚舉表示,可用按位或合併多個特性
這裡有個要注意的地方:當某個 View 被設為 AccessibilityElement 時,它的 subviews 會一併被屏蔽。這有時反而好用——例如一個 View 內含多個 Label,你不希望它們被逐一朗讀,就可以把父 View 設為可存取,再把它的 accessibilityLabel 設成所有子 Label 文案的合併。
事件方面,最簡單的就是前面提過的單指輕點兩下。若 AccessibilityElement 實作了 accessibilityActivate() 並回傳 true,就會呼叫這個方法;否則等同於在 accessibilityActivationPoint 這個位置做一次 Tap。
設想一個場景:某個 UIView 內含一組可互動內容,彼此獨立,但它們並不是以子 View 的形式存在,而是用 Quartz 2D 或 Core Text 渲染出來的,因此無法用上面的方式變成 AccessibilityElement。這種情況下,這個 UIView 需要遵循 UIAccessibilityContainer,把內部每一塊獨立內容描述成 UIAccessibilityElement 實例——此時它就是一個 Accessibility Container。
實作步驟如下。iOS 8 之後的做法是:Container 的 isAccessibilityElement 必須設為 false,然後建立所有 UIAccessibilityElement 實例並賦給 accessibilityElements 屬性。以下假設在一個 UIView 子類中,用 updateAccessibleElements 方法維護這些實例,當畫面內容變化或 VoiceOver 開關狀態改變時呼叫它以更新。偽代碼:
internal func updateAccessibleElements() { guard UIAccessibilityIsVoiceOverRunning() else { self.accessibilityElements = nil return } self.isAccessibilityElement = false var elements = [AnyObject]() let element1 = UIAccessibilityElement(accessibilityContainer: self) element1.accessibilityLabel = "element1" element1.accessibilityTraits = UIAccessibilityTraitStaticText element1.accessibilityFrame = UIAccessibilityConvertFrameToScreenCoordinates(element1FrameInSelf, self) elements.append(element1) ... self.accessibilityElements = elements }若要支援 iOS 8 以下,就得實作下面三個方法,麻煩得多:
// accessibilityElement的個數 public func accessibilityElementCount() -> Int // 返回指定Index的accessibilityElement public func accessibilityElementAtIndex(index: Int) -> AnyObject? // 返回指定accessibilityElement的Index public func indexOfAccessibilityElement(element: AnyObject) -> Int
用這種方式通常得自己維護一個包含所有元素的陣列,再依陣列回傳上面三個值。這種寫法累贅,而且畫面更新時還要主動發通知告訴系統元素有變動。所以若最低版本能定在 iOS 8,直接設 accessibilityElements 屬性會科學得多。
順帶一提,UIAccessibilityElement 這個類的設計有點令人困惑:既然 NSObject 的 UIAccessibility 擴展已經有 accessibilityLabel、accessibilityHint 這些屬性,為何類裡又要重複宣告一次,顯得有些冗餘。
前面只談了最簡單的單指輕點兩下。常見的 Actions 其實有這些,每個都對應一個方法,覆寫即可自訂邏輯:
Activate:單指輕點兩次
public func accessibilityActivate() -> Bool
Escape:單指畫 Z 手勢,通常用於關閉模態頁或返回上一頁
public func accessibilityPerformEscape() -> Bool
Magic Tap:雙指輕點兩次,觸發 most-intended action
public func accessibilityPerformMagicTap() -> Bool
Three-Finger Scroll:三指滑動,觸發畫面水平或垂直捲動
public func accessibilityScroll(direction: UIAccessibilityScrollDirection) -> Bool
Increment:單指上滑,需先將 accessibilityTraits 設為 UIAccessibilityTraitAdjustable,否則不會被呼叫
public func accessibilityIncrement()
Decrement:單指下滑,同樣需要 UIAccessibilityTraitAdjustable
public func accessibilityDecrement()
其中 Escape、Magic Tap、Three-Finger Scroll 這幾種手勢支援沿響應鏈向上尋找對應方法:使用者做出手勢後,系統先看當前 VoiceOver 焦點元素有沒有實作,沒有就往上一層找。因此像全域性操作,把方法寫在上層 View 或 ViewController 會更合適。其實不少系統組件預設就實作了部分手勢,例如 UINavigationController 與 UIAlertController 都支援 Escape。
Accessibility 提供了一系列通知。例如你可以監聽 UIAccessibilityVoiceOverStatusChanged,即時掌握 VoiceOver 的開啟與關閉。
也可以由 App 主動發通知讓系統做出反應。比如畫面上的元素有變動時,可以送 UIAccessibilityLayoutChangedNotification。發送時要用專用的 UIAccessibilityPostNotification,它帶兩個參數:通知名,以及要讓 VoiceOver 朗讀的字串或新的焦點元素。
UIAccessibilityPostNotification(UIAccessibilityLayoutChangedNotification, self.myFirstElement)
AccessibilityElement 的資訊盡量精簡,accessibilityLabel 不要塞入提示性文案,以免造成資訊干擾。
TableView 的每個 Cell 資訊要盡量合併,讓整個 Cell 成為一個 AccessibilityElement,避免在無意義的冗餘元素之間反覆切換。Cell 內有多個按鈕時,可以考慮用 Magic Tap,在其 Action 中彈出 sheet 樣式的 UIAlertController 供使用者選擇。
自訂的模態頁面記得把 accessibilityViewIsModal 設為 true,並盡量支援 Escape 手勢退出。
純裝飾、沒有實際意義的元素,把 accessibilityElementsHidden 設為 true,減少操作過程中的干擾。
參考文件:UIAccessibility Protocol、Supporting Accessibility、Accessibility Programming Guide for iOS。