Java Swing 無障礙設計指南：依循 508 條款建構可螢幕閱讀器存取的 GUI 應用

完整指南教導如何讓 Swing 應用符合美國 508 條款無障礙標準，涵蓋組件描述性命名、鍵盤導航、邏輯關係建立、複雜元件渲染器可及性、自動化驗證報告產生等實務技巧。

核心要求 (508 條款)

• 所有操作提供等價鍵盤操作。
• 設定助記符、加速鍵、邏輯 Tab 順序。
• 組件命名、描述、ToolTip 完整。
• 圖示/圖形提供文字替代描述。
• 複雜元件 (表格、樹、清單) 需可被螢幕閱讀器逐項讀取。

Swing 無障礙 API

• 所有 Swing 元件實作 Accessible 介面，提供 AccessibleContext。
• setAccessibleName(String)：螢幕閱讀器讀出的名稱。
• setAccessibleDescription(String)：詳細說明。
• 預設值：JLabel 文字 → Name，ToolTip → Description，但建議**顯式設定**。

輔助工具箱

AccessibilityUtils 核心方法

setAccessibleValues(ResourceBundle, Accessible, AccessibleValues) // 批次設定名稱/描述/助記符/ToolTip/邊框標題
setMemberRelationship(Accessible group, Collection members)       // 建立 MEMBER_OF 關係 (如 RadioButton 群組)
setLabelRelationship(Accessible label, Accessible target)         // 建立 LABEL_FOR / LABELLED_BY (如 JLabel 標記 JTextField)

AccessibleValues 封裝常用屬性

name, shortDescription, longDescription, toolTip, text, borderText, mnemonic

鍵盤導航強化

• 助記符 (setMnemonic)：Alt+字母 直接跳轉，全域唯一，優先給選單項、重要按鈕、各群組首項。
• Tab 順序：依加入容器順序，或用 setNextFocusableComponent / FocusTraversalPolicy 自訂。
• 初始焦點：WindowListener.windowActivated → requestFocusInWindow()，或設定 RootPane.setDefaultButton。

複雜元件渲染器可及性

• JList/JTable/JTree/JComboBox 使用 Renderer 繪製，Renderer 元件同樣需設定可及性屬性。
• 自訂 ListCellRenderer 時，在 getListCellRendererComponent 回傳前呼叫 setAccessibleValues。

自動化驗證報告

AccessibilityUtils.output(Component, PrintWriter, Outputter) 支援三種輸出器：

• TextOutputter：純文字報告。
• HtmlOutputter：瀏覽器可視化報告 (含顏色標示 OK/Warning/Error)。
• XmlOutputter：XML 報告可進一步 XSLT 轉換，含 DTD 定義。

報告包含元件階層、屬性值、AccessibleContext 完整欄位、關係集合，缺失項標示 Warning/Error。

實務建議

1. 開發初期即整合工具箱，避免事後補修成本高。
2. 使用 ResourceBundle 支援多國語系無障礙文案。
3. 將驗證報告納入 CI 流程，作為自動化測試門檻。