インスタンスメソッド

accessibilityRotor(_:entries:entryID:entryLabel:)

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

iOS 15.0+ iPadOS 15.0+ macOS 12.0+ Mac Catalyst 15.0+

tvOS 15.0+ watchOS 8.0+ visionOS 1.0+

func accessibilityRotor<EntryModel, ID>(

_ systemRotor: AccessibilitySystemRotor,

entries: [EntryModel],

entryID: KeyPath<EntryModel, ID>,

entryLabel: KeyPath<EntryModel, String>

) -> some View where ID : Hashable

パラメータ

systemRotor

このカスタムローターによってオーバーライドされるシステム提供のローター。

entries

ローターのエントリを生成するために使用される値の配列。

entryID

エントリの ID の生成に使用できるエントリタイプのキーパス。ID は、ForEach の ID または ScrollView 内の明示的な id 呼び出しと一致する必要があります。

entryLabel

すべてのローターエントリのユーザーに可視のラベルを取得するために使用できるエントリタイプのキーパス。これは、ユーザーがローターのエントリのリストを開くときに macOS で使用されます。

議論

アクセシビリティローターは、アクセシビリティユーザーがユーザーインターフェイスの特定の要素、およびオプションでそれらの要素内の特定の範囲のテキストにすばやく移動するためのショートカットです。

この修飾子を使用するには、ローターを ScrollView に付属させるか、ForEach などの ScrollView 内のアクセシビリティ要素に直接付属させる必要があります。ユーザーがこのローターからエントリに移動すると、SwiftUI は必要に応じてエントリを所定の位置に自動的にスクロールします。

以下の例では、メッセージアプリケーションがローターを作成し、ユーザーがメッセージの垂直スタックの見出しに移動できるようにします。