Documentation


アクセシビリティの基礎 (Accessibility fundamentals)


あなたの SwiftUI アプリを、障害のある人を含むすべての人がアクセスできるようにします。

概要


すべての Apple UI フレームワークと同様、SwiftUI にはアクセシビリティサポートが組み込まれています。このフレームワークは、ナビゲーションビュー、リスト、テキストフィールド、スライダー、ボタンなどの一般的な要素をイントロスペクト(内観)し、基本的なアクセシビリティラベルと値をデフォルトで提供します。これらの標準のアクセシビリティ機能を有効にするために追加の作業を行う必要はありません。



SwiftUI は、あなたのアプリのアクセシビリティを強化するのに役立つツールも提供します。必要な機能強化を見つけるには、VoiceOver、音声コントロール、スイッチコントロールなどのアクセシビリティ機能を備えたアプリを使用してみるか、これらの機能を定期的に使用するあなたのアプリのユーザーからフィードバックを受け取ります。次に、SwiftUI が提供するアクセシビリティビュー修飾子を使用して、体験を向上させます。たとえば、accessibilityLabel(_:) または accessibilityValue(_:) ビュー修飾子を使用して、UI の要素にアクセシビリティラベルを明示的に追加できます。


あなたのアプリが実行されるすべてのプラットフォームのアクセシビリティ修飾子の使用をカスタマイズして下さい。たとえば、iOS アプリと共通のコード基礎を共有するコンパニオン Apple Watch アプリのアクセシビリティ要素を調整する必要があるかもしれません。AppKit または UIKit コントロールを SwiftUI に統合する場合は、アクセシビリティラベルを公開して NSViewRepresentable (NSViewRepresentable)ビューまたは UIViewRepresentable (UIViewRepresentable) ビューからアクセスできるようにするか、基になるアクセシビリティラベルが利用できない場合はカスタムアクセシビリティ情報を提供します。


設計のガイダンスについては、ヒューマンインターフェイスガイドラインの アクセシビリティ を参照してください。






本質的


{} アクセシブルビューの作成


SwiftUI ビューにアクセシビリティ修飾子を適用することで、アプリを誰にでもアクセスできるようにします。



アクセシブルな要素の作成


func accessibilityElement(children: AccessibilityChildBehavior) -> some View

新しいアクセシビリティ要素を作成するか、既存のアクセシビリティ要素の AccessibilityChildBehavior を変更します。


func accessibilityChildren<V>(children: () -> V) -> some View

既存のアクセシビリティ要素の子を 1 つ以上の新しい合成アクセシビリティ要素に置き換えます。


func accessibilityRepresentation<V>(representation: () -> V) -> some View

このビューの 1 つ以上のアクセシビリティ要素を新しいアクセシビリティ要素に置き換えます。


struct AccessibilityChildBehavior

新しい親要素の子要素の動作を定義します。



要素の同一性確認


func accessibilityIdentifier(String) -> ModifiedContent<Self, AccessibilityAttachmentModifier>

指定した文字列を使用してビューを識別します。



要素を非表示にする


func accessibilityHidden(Bool) -> ModifiedContent<Self, AccessibilityAttachmentModifier>

このビューをシステムのアクセシビリティ機能から非表示にするかどうかを指定します。


サポートする型


struct AccessibilityTechnologies

システムで利用できるアクセシビリティ技術。


struct AccessibilityAttachmentModifier

アクセシビリティプロパティをビューに追加するビュー修飾子






以下も見よ


Accessible appearance

あなたのアプリのインターフェース内のコンテンツの読みやすさを向上させます。


Accessible controls

あなたのアプリが実行できるアクションへのアクセスを改善します。


Accessible descriptions

インターフェイス要素が何を表しているのかを人々が理解できるように説明します。


Accessible navigation

ユーザーがローターを使用して特定のユーザーインターフェイス要素に移動できるようにします。














トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ