構造体

AccessibilityFocusState

VoiceOver などのアクティブなアクセシビリティ技術のフォーカスが変更されると、SwiftUI が更新する値を読み書きできるプロパティラッパータイプ。

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

tvOS 15.0+ watchOS 8.0+ visionOS 1.0+

0@propertyWrapper @frozen
struct AccessibilityFocusState<Value> where Value : Hashable

概観

この機能を使用して、VoiceOver またはその他のアクセシビリティ技術がプログラムによって特定の要素に焦点を当てるように要求したり、VoiceOver またはその他のアクセシビリティ技術が特定の要素に焦点を当てているかどうかを判断したりできます。 accessibilityFocused(_:equals:) または accessibilityFocused(_:) をこのプロパティラッパーと組み合わせて使用して、アクセシビリティフォーカスを取得または設定したいアクセシビリティ要素を識別します。アクセシビリティフォーカスが、変更されたアクセシビリティ要素に入ると、フレームワークは、与えられたプロトタイプ値と一致するように、このプロパティのラップされた値を更新します。アクセシビリティのフォーカスが離れると、SwiftUI は optional のプロパティのラップされた値を nil にリセットするか、ブール型プロパティのラップされた値を false にリセットします。プロパティの値をプログラム的に設定すると逆の効果があり、更新された値に関連したアクセシビリティ要素にアクセシビリティフォーカスが移動します。

以下の例では、notification (通知)が変更され、その isPriority プロパティが true の場合、アクセシビリティフォーカスはビューのコンテンツの残りの上にある通知 Text 要素に移動します。

struct CustomNotification: Equatable {
var text: String
var isPriority: Bool
}
struct ContentView: View {
@Binding var notification: CustomNotification?
@AccessibilityFocusState var isNotificationFocused: Bool
var body: some View {
VStack {
if let notification = self.notification {
Text(notification.text)
.accessibilityFocused($isNotificationFocused)
}
Text("The main content for this view.")
}
.onChange(of: notification) { notification in
if (notification?.isPriority == true) {
isNotificationFocused = true
}
}
}
}

アクセシビリティ要素のツリーにアクセシビリティフォーカスが全く存在しない場合、またはアクセシビリティ技術がアクティブでない場合を考慮して、ラップされた値は optional またはブール値でなければなりません。

AccessibilityFocusState の一部のイニシャライザでは、アクセシビリティ技術を指定して、この結合が適用されるアクセシビリティフォーカスの型を決定することもできます。アクセシビリティ技術を指定しない場合、SwiftUI はアクティブなすべてのアクセシビリティ技術の any と全ての集合体を使用します。