提高可組合項的無障礙程度

嘗試讓應用程式中的可組合項更容易存取。您可以透過下列步驟提升可組合項的無障礙程度:

  • 描述可組合函式
  • 新增互動
  • 處理複雜的 UI

描述可組合函式

如要說明可組合項,請使用 Modifier.semantics 宣告其語意屬性 (例如 rolelabelstate 或動作)。無障礙服務可以讀取這些語意屬性,並使用相關資訊與 UI 互動及播報 UI 內容。

Role 屬性尤其重要,因為它會為無障礙服務提供必要背景資訊,以便播報元件的用途和預期互動。舉例來說,假設自訂圖示的行為類似可點選的按鈕。將角色設為 Role.button,即可確保螢幕閱讀器將其視為互動式元素,而非靜態圖片。

詳情請參閱「語意」。

新增互動

如要為可組合項新增互動,請使用 clickabletoggleable 修飾符。這些修飾符內建無障礙服務可讀取的語意屬性。如要更輕鬆地執行複雜的觸控螢幕手勢,請使用 CustomAccessibilityAction

詳情請參閱「自訂動作」。

處理複雜的 UI

雖然 Compose 預設支援許多無障礙功能,但較複雜的 UI 可能需要更自訂的行為。您可以邏輯方式建構 UI 階層,並為無障礙服務提供邏輯閱讀順序,讓複雜的 UI 更容易存取。

以邏輯方式建構 UI 階層:如果父項可組合函式包含多個子項元素,您可以明確指定這些元素的群組方式,或完全覆寫這些元素。詳情請參閱「合併及清除」。

控制遍歷順序:如果 Compose 的預設朗讀順序不夠完善,您可以手動控制螢幕閱讀器瀏覽 UI 元素的方式。詳情請參閱「修改遍歷順序」。

控制焦點:使用鍵盤和 D-Pad 導覽時,您可以手動覆寫焦點遍歷順序。詳情請參閱「變更焦點行為」和「變更焦點遍歷順序」。

其他資源

如要進一步瞭解如何提高 UI 的無障礙程度,請參閱下列其他資源:

說明文件

Views content