Documentation


Accessibility modifiers


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

概要


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


SwiftUI はまた、あなたのアプリのアクセシビリティを強化するのに役立つツールも提供します。たとえば、accessibilityLabel(_:) または accessibilityValue(_:) ビュー修飾子を使用して、あなたの UI の要素にアクセシビリティラベルを明示的に追加できます。


あなたのアプリにアクセシビリティ機能を追加する方法の詳細については、アクセシビリティの基礎 を参照してください。





トピックス


ラベル


func accessibilityLabel<S>(S) -> ModifiedContent<Self, AccessibilityAttachmentModifier>

その内容を説明するラベルをビューに追加します。


func accessibilityLabel(Text) -> ModifiedContent<Self, AccessibilityAttachmentModifier>

その内容を説明するラベルをビューに追加します。


func accessibilityLabel(LocalizedStringKey) -> ModifiedContent<Self, AccessibilityAttachmentModifier>

その内容を説明するラベルをビューに追加します。


func accessibilityInputLabels([LocalizedStringKey]) -> ModifiedContent<Self, AccessibilityAttachmentModifier>

ユーザーがビューを識別するための代替入力ラベルを設定します。


func accessibilityInputLabels<S>([S]) -> ModifiedContent<Self, AccessibilityAttachmentModifier>

ユーザーがビューを識別するための代替入力ラベルを設定します。


func accessibilityInputLabels([Text]) -> ModifiedContent<Self, AccessibilityAttachmentModifier>

ユーザーがビューを識別するための代替入力ラベルを設定します。


func accessibilityLabeledPair<ID>(role: AccessibilityLabeledPairRole, >id: ID, in: Namespace.ID) -> some View

ラベルを表すアクセシビリティ要素と、一致する内容の要素をペアにします。




func accessibilityValue<S>(S) -> ModifiedContent<Self,AccessibilityAttachmentModifier>

ビューに含まれる値のテキストによる説明を追加します。


func accessibilityValue(LocalizedStringKey) -> ModifiedContent%ltSelf, AccessibilityAttachmentModifier>

ビューに含まれる値のテキストによる説明を追加します。


func accessibilityValue(Text) -> ModifiedContent<Self, AccessibilityAttachmentModifier>

ビューに含まれる値のテキストによる説明を追加します。


ヒント


func accessibilityHint(LocalizedStringKey) -> ModifiedContent<Self, AccessibilityAttachmentModifier>

ビューのアクションを実行した後に何が起こるかをユーザーに伝えます。


func accessibilityHint(Text) -> ModifiedContent<Self, AccessibilityAttachmentModifier>

ビューのアクションを実行した後に何が起こるかをユーザーに伝えます。


func accessibilityHint<S>(S) -> ModifiedContent<Self, AccessibilityAttachmentModifier>

ビューのアクションを実行した後に何が起こるかをユーザーに伝えます。


アクション


func accessibilityAction(AccessibilityActionKind, () Void) -> ModifiedContent>Self, AccessibilityAttachmentModifier>

アクセシビリティアクションをビューに追加します。アクションを使用すると、VoiceOver などの支援テクノロジーがアクションを呼び出すことでビューで操作できるようになります。


func accessibilityActions<Content>(() -> Content) -> some View

複数のアクセシビリティアクションをビューに追加します。


func accessibilityAction(named: Text, () -> Void) -> ModifiedContent<Self, AccessibilityAttachmentModifier>

アクセシビリティアクションをビューに追加します。アクションを使用すると、VoiceOver などの支援テクノロジーがアクションを呼び出すことでビューで操作できるようになります。


func accessibilityAction<S>(named: S, () -> Void) -> ModifiedContent<Self, AccessibilityAttachmentModifier>

アクセシビリティアクションをビューに追加します。 アクションを使用すると、VoiceOver などの支援テクノロジーがアクションを呼び出すことでビューで操作できるようになります。


func accessibilityAction(named: LocalizedStringKey, () -> Void) -> ModifiedContent<Self, AccessibilityAttachmentModifier>

アクセシビリティアクションをビューに追加します。 アクションを使用すると、VoiceOver などの支援テクノロジーがアクションを呼び出すことでビューで操作できるようになります。


func accessibilityAction<Label>(action: () -> Void, label: () -> Label) -> some View

アクセシビリティアクションをビューに追加します。 アクションを使用すると、VoiceOver などの支援テクノロジーがアクションを呼び出すことでビューで操作できるようになります。


func accessibilityAdjustableAction((AccessibilityAdjustmentDirection) -> Void) -> ModifiedContent<Self, AccessibilityAttachmentModifier>

アクセシビリティで調整可能なアクションをビューに追加します。アクションを使用すると、VoiceOver などの支援テクノロジがアクションを呼び出すことでビューで操作できるようになります。


func accessibilityScrollAction((Edge) -> Void) -> ModifiedContent<Self, AccessibilityAttachmentModifier>

アクセシビリティスクロールアクションをビューに追加します。アクションを使用すると、VoiceOver などの支援テクノロジーがアクションを呼び出すことでビューで操作できるようになります。



ジェスチャ


func accessibilityActivationPoint(CGPoint) -> ModifiedContent<Self, AccessibilityAttachmentModifier>

要素の活性化ポイントは、位置支援テクノロジーがジェスチャを開始するために使用するものです。


func accessibilityActivationPoint(UnitPoint) -> ModifiedContent<Self, AccessibilityAttachmentModifier>

要素の活性化ポイントは、位置支援テクノロジーがジェスチャを開始するために使用するものです。


func accessibilityDirectTouch(Bool, options: AccessibilityDirectTouchOptions) -> ModifiedContent<Self, AccessibilityAttachmentModifier>

このアクセシビリティ要素が直接タッチ領域であるかどうかを明示的に設定します。直接タッチ領域は、VoiceOver などの支援テクノロジーを通じて処理されるのではなく、タッチイベントをアプリに渡します。この修飾子は、直接タッチ領域の機能をカスタマイズするためのオプションの AccessibilityDirectTouchOptions オプションセットを受け入れます。
  Beta  


func accessibilityZoomAction((AccessibilityZoomGestureAction) -> Void) -> ModifiedContent<Self, AccessibilityAttachmentModifier>

アクセシビリティズームアクションをビューに追加します。アクションを使用すると、VoiceOver などの支援テクノロジーがアクションを呼び出すことでビューを操作できるようになります。



要素


func accessibilityElement(children: AccessibilityChildBehavior) -> some View

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


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

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


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

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



カスタムコントロール


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

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


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

このアクセシビリティ要素がユーザー操作に応答するかどうか、つまりスイッチコントロール、音声コントロールやフルキーボードアクセスなどのテクノロジによって操作されるかどうかを明示的に設定します。


カスタムコンテンツ


func accessibilityCustomContent(AccessibilityCustomContentKey, LocalizedStringKey, importance: AXCustomContent.Importance) -> ModifiedContent<Self, AccessibilityAttachmentModifier>

追加のアクセシビリティ情報をビューに追加します。


func accessibilityCustomContent(AccessibilityCustomContentKey, Text?, importance: AXCustomContent.Importance) -> ModifiedContent<Self, AccessibilityAttachmentModifier>

追加のアクセシビリティ情報をビューに追加します。


func accessibilityCustomContent<V>(LocalizedStringKey, V, importance: AXCustomContent.Importance) -> ModifiedContent<Self, AccessibilityAttachmentModifier>

追加のアクセシビリティ情報をビューに追加します。


func accessibilityCustomContent(Text, Text, importance: AXCustomContent.Importance) -> ModifiedContent<Self, AccessibilityAttachmentModifier>

追加のアクセシビリティ情報をビューに追加します。


func accessibilityCustomContent(LocalizedStringKey, LocalizedStringKey, importance: AXCustomContent.Importance) -> ModifiedContent<Self, AccessibilityAttachmentModifier>

追加のアクセシビリティ情報をビューに追加します。


func accessibilityCustomContent<V>(AccessibilityCustomContentKey, V, importance: AXCustomContent.Importance) -> ModifiedContent<Self, AccessibilityAttachmentModifier>

追加のアクセシビリティ情報をビューに追加します。


func accessibilityCustomContent(LocalizedStringKey, Text, importance: AXCustomContent.Importance) -> ModifiedContent<Self, AccessibilityAttachmentModifier>

追加のアクセシビリティ情報をビューに追加します。


ローターの作成


func accessibilityRotor<Content>(LocalizedStringKey, entries: () -> Content) -> some View

指定されたユーザー可視ラベルとコンテンツクロージャから生成されたエントリを持つアクセシビリティローターを作成します。


func accessibilityRotor<Content>(Text, entries: () -> Content) -> some View

指定されたユーザー可視ラベルとコンテンツクロージャから生成されたエントリを持つアクセシビリティローターを作成します。


func accessibilityRotor<L, Content>(L, entries: () -> Content) -> some View

指定されたユーザー可視ラベルとコンテンツクロージャから生成されたエントリを持つアクセシビリティローターを作成します。


func accessibilityRotor<EntryModel, ID>(LocalizedStringKey, entries: [EntryModel], entryID: KeyPath<EntryModel, ID>, entryLabel: KeyPath<EntryModel, String>) -> some View

指定されたユーザーに可視のラベルとエントリを使用して、アクセシビリティローターを作成します。


func accessibilityRotor<EntryModel, ID>(Text, entries: [EntryModel], entryID: KeyPath<EntryModel, ID>, entryLabel: KeyPath<EntryModel, String>) -> some View

指定されたユーザーに可視のラベルとエントリを使用して、アクセシビリティローターを作成します。


func accessibilityRotor<L, EntryModel, ID>(L, entries: [EntryModel], entryID: KeyPath<EntryModel, ID>, entryLabel: KeyPath<EntryModel, String>) -> some View

指定されたユーザーに可視のラベルとエントリを使用して、アクセシビリティローターを作成します。


func accessibilityRotor<EntryModel>(LocalizedStringKey, entries: [EntryModel], entryLabel: KeyPath<EntryModel, String>) -> some View

指定されたユーザーに可視のラベルとエントリを使用して、アクセシビリティローターを作成します。


func accessibilityRotor<EntryModel>(Text, entries: [EntryModel], entryLabel: KeyPath<EntryModel, String>) -> some View

指定されたユーザーに可視のラベルとエントリを使用して、アクセシビリティローターを作成します。


func accessibilityRotor<L, EntryModel>(L, entries: [EntryModel], entryLabel: KeyPath<EntryModel, String>) -> some View

指定されたユーザーに可視のラベルとエントリを使用して、アクセシビリティローターを作成します。


func accessibilityRotor(LocalizedStringKey, textRanges: [Range<String.Index>]) -> some View

指定されたユーザーに可視のラベルと、指定された各範囲のエントリを持つアクセシビリティローターを作成します。ローターは現在のアクセシビリティ要素にアタッチされ、各エントリはその要素の指定された範囲に移動します。


func accessibilityRotor(Text, textRanges: [Range<String.Index>]) -> some View

指定されたユーザーに可視のラベルと、指定された各範囲のエントリを持つアクセシビリティローターを作成します。ローターは現在のアクセシビリティ要素にアタッチされ、各エントリはその要素の指定された範囲に移動します。


func accessibilityRotor<L>(L, textRanges: [Range<String.Index>]) -> some View

指定されたユーザーに可視のラベルと、指定された各範囲のエントリを持つアクセシビリティローターを作成します。ローターは現在のアクセシビリティ要素にアタッチされ、各エントリはその要素の指定された範囲に移動します。



システムローターの置き換え


func accessibilityRotor<Content>(AccessibilitySystemRotor, entries: () -> Content) -> some View

指定されたシステム提供のローターを置き換えるアクセシビリティローターを作成します。


func accessibilityRotor<EntryModel, ID>(AccessibilitySystemRotor, entries: [EntryModel], entryID: KeyPath<EntryModel, ID>, entryLabel: KeyPath<<ntryModel, String>) -> some View

指定されたシステム提供のローターを置き換えるアクセシビリティローターを作成します。


func accessibilityRotor<EntryModel>(AccessibilitySystemRotor, entries: [EntryModel], entryLabel: KeyPath<EntryModel, String>) -> some View

指定されたシステム提供のローターを置き換えるアクセシビリティローターを作成します。


func accessibilityRotor(AccessibilitySystemRotor, textRanges: [Range<String.Index>]) -> some View

指定されたシステム提供のローターを置き換えるアクセシビリティローターを作成します。ローターは現在のアクセシビリティ要素に付属され、各エントリはその要素の指定された範囲に移動します。



ローターの構成


func accessibilityRotorEntry<ID>(id: ID, in: Namespace.ID) -> some View

このビューの Accessibility 要素をアクセシビリティローターのエントリに結び付ける明示的な ID を定義します。


func accessibilityLinkedGroup<ID>(id: ID, in: Namespace.ID) -> some View

複数のアクセシビリティ要素をリンクして、アクセシビリティ階層内で要素が互いに近くにない場合でも、ユーザーが 1 つの要素から別の要素にすばやく移動できるようにします。


func accessibilitySortPriority(Double) -> ModifiedContent<Self, AccessibilityAttachmentModifier>

このビューのアクセシビリティ要素のソート優先順位を、同じレベルの他の要素との相対で設定します。



フォーカス


func accessibilityFocused(AccessibilityFocusState<Bool>.Binding) -> some View

アクセシビリティ要素のフォーカス状態を与えられたブール値の状態に結合することにより、このビューを変更します。


func accessibilityFocused<Value>(AccessibilityFocusState<Value>.Binding, equals: Value) -> some View

アクセシビリティ要素のフォーカス状態を与えられた状態値に結合することで、このビューを変更します。



特性


func accessibilityAddTraits(AccessibilityTraits) -> ModifiedContent<Self, AccessibilityAttachmentModifier>

指定された特性をビューに追加します。


func accessibilityRemoveTraits(AccessibilityTraits) -> ModifiedContent<Self, AccessibilityAttachmentModifier>

指定された特性をこのビューから削除します。



同一性確認(Identity)


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

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



色の反転


func accessibilityIgnoresInvertColors(Bool) -> some View

このビューがシステムのスマート反転設定を無視するかどうかを設定します。



内容の説明


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 がテキストビューの内容を 1 文字ずつ読み上げるかどうかを設定します。



グラフ


func accessibilityChartDescriptor<R>(R) -> some View

グラフを表すビューに記述子を追加して、すべてのユーザーがグラフのコンテンツにアクセスできるようにします。



ラージコンテンツ


func accessibilityShowsLargeContentViewer() -> some View

ラージコンテンツビューアによって表示されるデフォルトのラージコンテンツビューを追加します。


func accessibilityShowsLargeContentViewer<V>(() -> V) -> some View

ラージコンテンツビューアによって表示されるカスタムラージコンテンツビューを追加します。



クイックアクション


func accessibilityQuickAction<Style, Content>(style: Style, content: () -> Content) -> some View

アクティブなときにシステムによって表示されるクイックアクションを追加します。


func accessibilityQuickAction<Style, Content>(style: Style, isActive: Binding<Bool>, content: () -> Content) -> some View

アクティブなときにシステムによって表示されるクイックアクションを追加します。






以下も見よ


Appearance modifiers

ビューの前景と背景のスタイル、コントロール、表示設定を構成します。


Text and symbol modifiers

あなたのビュー内のテキストのレンダリング、選択、入力を管理します。


Auxiliary view modifiers

ツールバーやコンテキストメニューなどのサポートビューを追加して構成します。


Chart view modifiers

Swift Charts で宣言するチャート(グラフ)を構成します。














トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ