XCode 26.3 日本語化計画
元のドキュメント： developer.apple.com/documentation/swiftui/view-accessibility
API コレクション
Accessibility modifiers (アクセス可能にする修飾子)
あなたの SwiftUI アプリを、障がいのある方を含むすべての人にとって使いやすい(アクセス可能な)ものにしましょう。
概観
Apple の他の UI フレームワークと同様に、SwiftUI にはアクセシビリティ機能が組み込まれています。このフレームワークは、ナビゲーションビュー、リスト、テキストフィールド、スライダー、ボタンなどの一般的な要素を分析し、基本的なアクセシビリティラベルと値をデフォルトで提供します。これらの標準的なアクセシビリティ機能を有効にするために、特別な作業は必要ありません。
SwiftUI には、あなたのアプリのアクセシビリティを向上させるためのツールも提供されています。例えば、accessibilityLabel(_:) や accessibilityValue(_:) といったビュー修飾子を使って、UI 要素にアクセシビリティラベルを明示的に追加できます。
あなたのアプリにアクセシビリティ機能を追加する方法について詳しくは、アクセシビリティの基礎 をご覧ください。
トピックス
以下、View をビューと記載する場合があります。
ラベル
ビューの内容を説明するラベルを追加します。
func accessibilityLabel(_:isEnabled:)
ビューの内容を説明するラベルを追加します。
func accessibilityLabel<V>(content: (PlaceholderContentView<Self>) -> V) -> some View
ビューの内容を説明するラベルを追加します。
func accessibilityInputLabels(_:)
ユーザーがビューを識別するために使用する代替入力ラベルを設定します。
func accessibilityInputLabels(_:isEnabled:)
ユーザーがビューを識別するために使用する代替入力ラベルを設定します。
ラベルを表すアクセシビリティ要素と、一致するコンテンツの要素をペアにします。
値
ビューに含まれる値のテキストによる説明を追加します。
func accessibilityValue(_:isEnabled:)
ビューに含まれる値のテキストによる説明を追加します。
ヒント
ビューのアクションを実行した後に何が起こるかをユーザーに伝えます。
func accessibilityHint(_:isEnabled:)
ビューのアクションを実行した後に何が起こるかをユーザーに伝えます。
アクション
ビューにアクセシビリティアクションを追加します。アクションを使用すると、VoiceOver などの支援技術がアクションを呼び出すことでビューを操作できるようになります。
func accessibilityActions<Content>(() -> Content) -> some View
ビューに複数のアクセシビリティアクションを追加します。
func accessibilityAction(named:_:)
ビューにアクセシビリティアクションを追加します。アクションを使用すると、VoiceOver などの支援技術がアクションを呼び出すことでビューを操作できるようになります。
func accessibilityAction<Label>(action: () -> Void, label: () -> Label) -> some View
ビューにアクセシビリティアクションを追加します。アクションを使用すると、VoiceOver などの支援技術がアクションを呼び出すことでビューを操作できるようになります。
func accessibilityAction<I, Label>(intent: I, label: () -> Label) -> some View
ビューに、label の内容でラベル付けされたアクセシビリティ・アクションを追加します。アクションを使用すると、VoiceOver などの支援技術がアクションを呼び出すことでビューを操作できるようになります。アクションが実行されると、intent が呼び出されます。
actionKind を表すアクセシビリティアクションをビューに追加します。アクションを使用すると、VoiceOver などの支援技術がアクションを呼び出すことでビューを操作できるようになります。アクションが実行されると、intent が呼び出されます。
func accessibilityAction(named:intent:)
ビューに「name」というラベルのアクセシビリティアクションを追加します。アクションを使用すると、VoiceOver などの支援技術がアクションを呼び出すことでビューを操作できるようになります。アクションが実行されると、intent が呼び出されます。
ビューにアクセシビリティ調整可能なアクションを追加します。アクションを使用すると、VoiceOver などの支援技術がアクションを呼び出すことでビューを操作できるようになります。
ビューにアクセシビリティスクロールアクションを追加します。アクションを使用すると、VoiceOver などの支援技術がアクションを呼び出すことでビューを操作できるようになります。
ジェスチャ
func accessibilityActivationPoint(_:)
要素の起動ポイントとは、支援技術がジェスチャーを開始するために使用する場所のことです。
func accessibilityActivationPoint(_:isEnabled:)
要素の起動ポイントとは、支援技術がジェスチャーを開始するために使用する場所のことです。
func accessibilityDragPoint(_:description:)
支援技術がドラッグ操作を開始するために使用すべきポイント。
func accessibilityDragPoint(_:description:isEnabled:)
支援技術がドラッグ操作を開始するために使用すべきポイント。
func accessibilityDropPoint(_:description:)
支援技術がドラッグ操作を終了するために使用すべきポイント。
func accessibilityDropPoint(_:description:isEnabled:)
支援技術がドラッグ操作を終了するために使用すべきポイント。
このアクセシビリティ要素が直接タッチ領域であるかどうかを明示的に設定します。直接タッチ領域は、VoiceOver などの支援技術を介さずに、タッチイベントをアプリに直接渡します。この修飾子は、オプションの AccessibilityDirectTouchOptions オプションセットを受け入れ、直接タッチ領域の機能をカスタマイズできます。
ビューにアクセシビリティズームアクションを追加します。アクションを使用すると、VoiceOver などの支援技術がアクションを呼び出すことでビューを操作できるようになります。
struct AccessibilityDirectTouchOptions
ビューの直接タッチ領域の機能を定義するオプションセット。
struct AccessibilityZoomGestureAction
VoiceOver などの支援技術を用いてユーザーが行うズームジェスチャーの位置情報と方向情報。
要素
func accessibilityElement(children: AccessibilityChildBehavior) -> some View
新しいアクセシビリティ要素を作成するか、既存のアクセシビリティ要素の AccessibilityChildBehavior を変更します。
func accessibilityChildren<V>(children: () -> V) -> some View
既存のアクセシビリティ要素の子要素を、1 つ以上の新しい合成アクセシビリティ要素に置き換えます。
func accessibilityHidden(Bool) -> ModifiedContent<Self, AccessibilityAttachmentModifier>
このビューをシステムのアクセシビリティ機能から非表示にするかどうかを指定します。
このビューをシステムのアクセシビリティ機能から非表示にするかどうかを指定します。
struct AccessibilityChildBehavior
新しい親要素の子要素の動作を定義します。
カスタムコントロール
func accessibilityRepresentation<V>(representation: () -> V) -> some View
このビューのアクセシビリティ要素を 1 つ以上、新しいアクセシビリティ要素に置き換えます。
このアクセシビリティ要素がユーザー操作に反応するかどうか、つまりスイッチ制御、音声制御、フルキーボードアクセスなどの技術によって操作されるかどうかを明示的に設定します。
このアクセシビリティ要素がユーザー操作に反応するかどうか、つまりスイッチ制御、音声制御、フルキーボードアクセスなどの技術によって操作されるかどうかを明示的に設定します。
カスタムコンテンツ
func accessibilityCustomContent(_:_:importance:)
アクセシビリティに関する追加情報をビューに追加します。
ローターを使った作業
func accessibilityRotor(_:entries:)
指定されたユーザー可視ラベルと、コンテンツクロージャから生成されたエントリを使用して、アクセシビリティローターを作成します。
func accessibilityRotor(_:entries:entryID:entryLabel:)
指定されたユーザー可視ラベルとエントリを使用して、アクセシビリティローターを作成します。
func accessibilityRotor(_:entries:entryLabel:)
指定されたユーザー可視ラベルとエントリを使用して、アクセシビリティローターを作成します。
func accessibilityRotor(_:textRanges:)
指定されたユーザー可視ラベルと、指定された各範囲のエントリを持つアクセシビリティローターを作成します。ローターは現在のアクセシビリティ要素に付属され、各エントリはその要素の指定された範囲に配置されます。
ローターの作成
protocol AccessibilityRotorContent
アクセシビリティローター内のコンテンツ。
ローターの構成
func accessibilityRotorEntry<ID>(id: ID, in: Namespace.ID) -> some View
このビューのアクセシビリティ要素をアクセシビリティローターのエントリに結び付ける明示的な識別子を定義します。
func accessibilityLinkedGroup<ID>(id: ID, in: Namespace.ID) -> some View
複数のアクセシビリティ要素をリンクさせることで、アクセシビリティ階層内で要素同士が離れていても、ユーザーが要素間を素早く移動できるようにします。
func accessibilitySortPriority(Double) -> ModifiedContent<Self, AccessibilityAttachmentModifier>
このビューのアクセシビリティ要素の並べ替え優先順位を、同じレベルにある他の要素との相対的な関係で設定します。
Focus (焦点)
func accessibilityFocused(AccessibilityFocusState<Bool>.Binding) -> some View
このビューのアクセシビリティ要素のフォーカス状態を、与えられたブール状態値に結合することで、このビューを変更します。
func accessibilityFocused<Value>(AccessibilityFocusState<Value>.Binding, equals: Value) -> some View
このビューのアクセシビリティ要素のフォーカス状態を、与えられた状態値に結合することで、このビューを変更します。
特性
func accessibilityAddTraits(AccessibilityTraits) -> ModifiedContent<Self, AccessibilityAttachmentModifier>
与えられた特性をビューに追加します。
指定された特性をこのビューから削除します。
要素の動作を説明する一連のアクセシビリティ特性。
識別子
func accessibilityIdentifier(String) -> ModifiedContent<Self, AccessibilityAttachmentModifier>
指定した文字列を使用してビューを識別します。
指定した文字列を使用してビューを識別します。
色の反転
func accessibilityIgnoresInvertColors(Bool) -> some View
このビューがシステムのスマート反転設定を無視するかどうかを設定します。
var accessibilityInvertColors: Bool
色(Color)を反転するシステム環境設定が有効かどうか。
var accessibilityDifferentiateWithoutColor: Bool
色(Color)を使用せずに区別するシステム環境設定が有効かどうか。
コンテンツの説明
func accessibilityTextContentType(AccessibilityTextContentType) -> ModifiedContent<Self, AccessibilityAttachmentModifier>
アクセシビリティテキストの内容の型を設定します。
func accessibilityHeading(AccessibilityHeadingLevel) -> ModifiedContent<Self, AccessibilityAttachmentModifier>
この見出しのアクセシビリティレベルを設定します。
VoiceOver
func speechAdjustedPitch(Double) -> some View
音声テキストのピッチを上げたり下げたりします。
func speechAlwaysIncludesPunctuation(Bool) -> some View
VoiceOver がテキストビュー内のすべての句読点を常に読み上げるべきかどうかを設定します。
func speechAnnouncementsQueued(Bool) -> some View
進行中のスピーチを中断するのではなく、保留中のアナウンスを既存のスピーチの後ろのキューに入れるかどうかを制御します。
func speechSpellsOutCharacters(Bool) -> some View
VoiceOver がテキストビューの内容を文字ごとに読み上げるかどうかを設定します。
グラフ
func accessibilityChartDescriptor<R>(R) -> some View
グラフを表すビューに説明を追加し、グラフの内容をすべてのユーザーが閲覧できるようにします。
説明の管理
func makeChartDescriptor() -> AXChartDescriptor
このビューに対応する AXChartDescriptor を作成し、それを返します。
必須
func updateChartDescriptor(AXChartDescriptor)
ビューまたは Environment の変更に基づいて、ビューの既存の AXChartDescriptor を更新します。
必須 デフォルトの実装が提供されます。
大容量コンテンツ
func accessibilityShowsLargeContentViewer() -> some View
ラージコンテンツビューアによって表示されるデフォルトのラージコンテンツビューを追加します。
func accessibilityShowsLargeContentViewer<V>(() -> V) -> some View
ラージコンテンツビューアによって表示されるカスタムラージコンテンツビューを追加します。
var accessibilityLargeContentViewerEnabled: Bool
ラージコンテンツビューアが有効かどうか。
クイックアクション
func accessibilityQuickAction<Style, Content>(style: Style, content: () -> Content) -> some View
システムがアクティブになったときに表示するクイックアクションを追加します。
システムがアクティブになったときに表示するクイックアクションを追加します。
以下も見よ
view 要素の構成
Appearance modifiers（表示修飾子)
View のフォアグラウンドとバックグラウンドのスタイル、コントロール、および表示構成を行います。
＠＠＠＠＠＠＠＠＠＠＠＠＠＠
０４／０３ここまで
＠＠＠＠＠＠＠＠＠＠＠＠＠＠
Text and symbol modifiers(テキストとシンボルの修飾子)
View 内でのテキストのレンダリング、選択、入力などを管理します。
Auxiliary view modifiers(補助のビュー修飾子)
ツールバーやコンテキストメニューなどの補助ビューを追加および構成します。
Chart view modifiers(チャート表示修飾子)
Swift の Charts で宣言したチャートを構成します。
＠＠＠＠＠＠＠＠＠＠＠＠＠＠
０４／０２ここまで
＠＠＠＠＠＠＠＠＠＠＠＠＠＠
トップへ
トップへ
トップへ
トップへ
トップへ
トップへ
トップへ
トップへ
トップへ
トップへ
トップへ
トップへ
トップへ
トップへ
トップへ
トップへ
トップへ
トップへ
トップへ
トップへ