元のドキュメント： developer.apple.com/documentation/swiftui/view/accessibilitychildren(children:)

インスタンスメソッド

accessibilityChildren(children:)

既存のアクセシビリティ要素の子要素を、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 accessibilityChildren<V>(@ViewBuilder children: () -> V) -> some View where V : View

パラメータ

children

フレームワークがアクセシビリティ要素を生成するために使用する、代替子ビューを表す ViewBuilder。

議論

この修飾子を使用すると、既存の要素の子要素を、あなたの指定した 1 つ以上の新しい合成アクセシビリティ要素に置き換えることができます。これにより、合成の非視覚的なアクセシビリティ要素を、視覚的なアクセシビリティ要素の子要素として設定することが可能になります。

SwiftUI は、必要に応じてアクセシビリティコンテナを暗黙的に作成します。アクセシビリティ要素が既に存在する場合、フレームワークはそれをアクセシビリティコンテナに変換します。

以下の例では、Canvas に固有のアクセシビリティ要素が一切含まれていない縦棒グラフが表示されています。Canvas に描画された各棒の値を表すアクセシビリティ要素を持つビューに accessibilityChildren(children:) 修飾子を追加することで、ビューをアクセシブルにすることができます。

var body: some View {
    Canvas { context, size in
        // Draw Graph
        for data in dataSet {
            let path = Path(
                roundedRect: CGRect(
                    x: (size.width / CGFloat(dataSet.count))
                    * CGFloat(data.week),
                    y: 0,
                    width: size.width / CGFloat(dataSet.count),
                    height: CGFloat(data.lines),
                cornerRadius: 5)
            context.fill(path, with: .color(.blue))
        }
        // Draw Axis and Labels
        ...
    }
    .accessibilityLabel("Lines of Code per Week")
    .accessibilityChildren {
        HStack {
            ForEach(dataSet) { data in
                RoundedRectangle(cornerRadius: 5)
                    .accessibilityLabel("Week \(data.week)")
                    .accessibilityValue("\(data.lines) lines")
            }
        }
    }
}