最近、新しいコードラボは、のために発売されたAndroidのカバーアクセシビリティにJetpackの作曲。

この記事では、JetpackComposeでアクセシビリティを実装する方法を学習します。

アプリのアクセシビリティを向上させるのに役立つ主なプロパティ

• タッチターゲットサイズ
• ラベルをクリックします
• カスタムアクション
• コンテンツの説明または視覚要素の説明
• 見出し
• カスタムマージ
• 状態の説明
• カスタムナビゲーション

• ユーザーがクリック、タッチ、または操作できる画面上の要素の幅と高さが少なくとも48dp。であることを確認する必要があります。
• これらのコントロールのサイズが動的に設定されている場合、またはコンテンツのサイズに基づいてサイズが変更されている場合は、sizeIn 修飾子を使用してサイズの下限を設定することを検討してください。

Text(
    text = "SizeIn sample",
    modifier = Modifier.sizeIn(
        minWidth = 48.dp,
        minHeight = 48.dp
    )
)

• あなたは上で見ることができるように、左 close button’s size was 24 dp、および修正後にそれがある48 dpされている必要。

• デフォルトでは、クリック可能な要素は、その要素をクリックすると何が行われるかについての情報を提供しません。したがって、TalkBackなどのアクセシビリティサービスは、非常に一般的なデフォルトの説明を使用します。
• ユーザーがこの要素をクリックするとどうなるかを説明する具体的な説明を提供できます。これは、アクセシビリティが必要なユーザーに最高のエクスペリエンスを提供するのに役立ちます。

• ご覧のとおり、左側のトークバックにはDouble-tap to activate、右側の改善後、と書かれていDouble-tap to read articleます。

カスタムアクション

• カスタムアクセシビリティアクションの助けを借りて、同じリストアイテムに関連するアクションをグループ化できます。
• 私たちは、のリスト渡すことができCustomAccessibilityActionさんへのcustomActions semantic property

コンテンツの説明または視覚要素の説明

• アクセシビリティサービスには、ピクセルだけに基づいて視覚要素を理解する方法がありません。
• ビジュアルのcomposablesようにImage、そのビジュアル要素のを渡すことができるIconパラメータを含めますcontentDescription。localized descriptionまたはnull、要素が純粋に装飾的である場合。

• 私たちは、の部分かを示すことができ、テキストがありheadings、ユーザーが⬇️⬆️上下にスワイプするかによって異なる見出し内をすばやく移動するのに役立ちます。
• heading semantics propertyこの構成可能オブジェクトが見出しであることを示すようにを設定できます。

• TalkBackなどのユーザー補助サービスは、画面を要素ごとにナビゲートします。
• デフォルトでは、少なくとも1つのセマンティクスプロパティを設定するJetpack Composeの各低レベルコンポーザブルは、フォーカスを受け取ります。

• Composablesセマンティクス修飾子とそのプロパティを使用して、一緒にマージできます。mergeDescendants

状態の説明

• コンポーザブルの状態のカスタム説明を追加することで、コンポーザブルコンポーネントのアクセシビリティを向上させることができます。
• たとえば、チェックボックスのステータスは「チェック済み」または「チェックなし」として読み取られます。修飾子内のstateDescription プロパティを使用して、この説明をカスタム説明に置き換えることができます。semantics

Focus Modifiers 異なる構成要素間のナビゲーションをカスタマイズするのに役立ちます

私たちはできる対話でフォーカスメカニズムで作曲次の助けを借りて修飾子。

• Modifier.focusTarget(）：コンポーネントをフォーカス可能にすることができます

Text(
    text = "Hello World",
    modifier = Modifier.focusTarget()
)

val (first, second) = FocusRequester.createRefs()
You can also pass lambda to customize the focus events behaviour
Text(
    text = "Hello World",
    modifier = Modifier
        .focusOrder(first) {
            this.down = second
        // down, left, right, up, previous, next, start, end
        }
)

val (first, second) = FocusRequester.createRefs()
Text(
    text = "FocusRequester",
    modifier = Modifier
        .focusRequester(second)
)
// requestFocus 
second.requestFocus()

Modifier.onFocusChanged { focusState ->
    with(focusState) {
        when {
            hasFocus -> {
                Log.d("A child of mine has focus!")
            }
            isFocused -> {
                Log.d("I'm focused!")
            }
        }
    }
}

参考文献

https://developer.android.com/codelabs/jetpack-compose-accessibility?authuser=4#0

https://developer.android.com/jetpack/compose/accessibility?authuser=4

連絡を取り合う