元のドキュメント: developer.apple.com/documentation/swiftui/view/accessibilityrepresentation(representation:)


インスタンスメソッド


accessibilityRepresentation(representation:)


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


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

tvOS 15.0+ visionOS 1.0+ watchOS 8.0+

nonisolated
func
accessibilityRepresentation<V>(@ViewBuilder representation: () -> V) -> some View where V : View




パラメータ


representation

アクセシビリティシステムがアクセシビリティ要素を生成するために使用する、非表示のビュー。



議論


カスタムスタイルを使用することで、あなたはコントロールにアクセス可能にすることができます。たとえば、あなたの作成したカスタム ToggleStyle は、Toggle のアクセシビリティ機能を自動的に継承します。親ビューのアクセシビリティ要素を使用できない場合は、代わりに accessibilityRepresentation(representation:) 修飾子を使用して下さい。この修飾子は、デフォルトのアクセシビリティ要素を、あなたの指定した別のアクセシビリティ要素に置き換えます。ビューが表示する内容を表すために、合成の非視覚的なアクセシビリティ要素を使用して下さい。


以下の例では、Slider を使用してそのステップ増分の表現を明示的に定義することで、カスタム調整可能なコントロールにアクセスできるようにしています。


var body: some View {
    VStack {
        SliderTrack(...) // Custom slider implementation.
    }
    .accessibilityRepresentation {
        Slider(value: $value, in: 0...100) {
            Text("Label")
        }
    }
}

SwiftUI は、representation クロージャ内であなたが提供したビューを非表示にして、非対話型にします。フレームワークは、アクセシビリティ要素を生成するためだけにそれを使用します。





以下も見よ


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


func accessibilityElement(children: AccessibilityChildBehavior) -> some View

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


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

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


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

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


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

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


struct AccessibilityChildBehavior

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














トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ