android-accessibility

Android アクセシビリティチェックリスト

手順

提供されたコンポーネントまたは画面について、以下のアクセシビリティの観点から分析します。

1. コンテンツの説明

• 確認事項：Image と Icon のコンポーザブルに、意味のある contentDescription が設定されていますか？
• 装飾目的：画像が純粋に装飾目的の場合は、contentDescription = null を使用します。
• 操作可能な要素：要素がクリック可能な場合、説明にはアイコン（例：「三角形」）ではなく、操作（例：「音楽を再生」）を記述します。

2. タッチターゲットのサイズ

• 基準：すべてのインタラクティブ要素で、最小 48x48dp とします。
• 修正方法：表示されるアイコンが小さい場合は、MinTouchTargetSize を使用するか、適切なパディングを設定した Box で囲みます。

3. 色のコントラスト

• 基準：WCAG AA では、通常のテキストに 4.5:1、大きなテキストやアイコンに 3.0:1 のコントラスト比が必要です。
• ツール：コントラストのロジックを使用して、背景との色のコントラストを確認します。

4. フォーカスとセマンティクス

• フォーカス順序：キーボードやスクリーンリーダーのフォーカスが論理的な順序（例：左上から右下）で移動することを確認します。
• グループ化：複雑な項目（テキストとアイコンを含む行など）には、Modifier.semantics(mergeDescendants = true) を使用して、単一の項目として読み上げられるようにします。
• 状態の説明：標準のセマンティクスだけでは不十分なカスタム状態（例：「選択済み」、「チェック済み」）を説明するには、stateDescription を使用します。

5. 見出し

• 移動：タイトルのテキストに Modifier.semantics { heading() } を設定すると、スクリーンリーダーのユーザーがセクション間を移動できます。

エージェントでの使用例

• 「この Image のコンテンツの説明を分析してください。適切ですか？」
• 「このボタンのタッチターゲットのサイズが少なくとも 48dp あるか確認してください。」
• 「このカスタム切り替えボタンは、『チェック済み』の状態を TalkBack に通知しますか？」