如何让SwiftUI ViewBuilder仅接受符合指定协议的视图作为输入？

我在SwiftUI中尝试用@ViewBuilder让包的使用者动态指定视图主体内容，但希望限制输入视图只能是我实现的几个默认视图（以此简化流程）。我定义了一个协议PopupBodyView，让所有允许的视图都遵循它，但当在构建器中传入多个视图时，会报错提示TupleView<(Text, Text)>需要遵循PopupBodyView。

原代码示例 #

协议与函数定义：

public protocol PopupBodyView: View { } // 我的每个默认视图都遵循此协议

func generateChildView(@ViewBuilder items: () -> PopupBodyView)
-> some PopupBodyView {
    return items()
}

调用时报错的代码：

extension Text: PopupBodyView { } // 添加协议遵循

contextMenu {
    Text("Test")
    Text("Test") // 错误：Instance method 'contextMenu(items:)' requires that 'TupleView<(Text, Text)>' conform to 'PopupBodyView'
}

错误原因 #

默认的@ViewBuilder在处理多个子视图时，会自动将它们包装成TupleView（比如两个视图对应TupleView<(V1, V2)>，三个对应TupleView<(V1, V2, V3)>），但这个TupleView并没有遵循我们自定义的PopupBodyView协议，因此编译器报错。

解决方案 #

我们需要自定义一个ResultBuilder，替代默认的@ViewBuilder，让它只接受符合PopupBodyView的视图，并且在处理多个视图时，将它们组合成一个遵循PopupBodyView的容器视图（比如VStack或自定义容器）。

步骤1：自定义ResultBuilder

@resultBuilder
struct PopupBodyBuilder {
    // 处理单个符合协议的视图
    static func buildBlock(_ content: PopupBodyView) -> some PopupBodyView {
        content
    }
    
    // 处理两个视图，组合成VStack（可替换为自定义容器）
    static func buildBlock(_ v1: PopupBodyView, _ v2: PopupBodyView) -> some PopupBodyView {
        VStack {
            v1
            v2
        }
    }
    
    // 处理三个视图，按需扩展更多参数的buildBlock
    static func buildBlock(_ v1: PopupBodyView, _ v2: PopupBodyView, _ v3: PopupBodyView) -> some PopupBodyView {
        VStack {
            v1
            v2
            v3
        }
    }
    
    // 处理可选视图（支持if/else逻辑）
    static func buildOptional(_ content: PopupBodyView?) -> some PopupBodyView {
        content ?? EmptyView()
    }
    
    // 处理条件分支（if/else）
    static func buildEither(first content: PopupBodyView) -> some PopupBodyView {
        content
    }
    
    static func buildEither(second content: PopupBodyView) -> some PopupBodyView {
        content
    }
}

步骤2：让容器视图遵循协议

extension VStack: PopupBodyView where Content: PopupBodyView { }
extension EmptyView: PopupBodyView { }

步骤3：修改函数使用自定义构建器

func generateChildView(@PopupBodyBuilder items: () -> some PopupBodyView) -> some PopupBodyView {
    return items()
}

最终调用示例

extension Text: PopupBodyView { }

contextMenu {
    Text("Test")
    Text("Test") // 现在可正常编译
}

补充说明 #

• 可根据需求将VStack替换为其他容器（如HStack、自定义容器视图），只要让该容器遵循PopupBodyView即可；
• 若需支持更多数量的子视图，需在PopupBodyBuilder中添加对应参数数量的buildBlock方法；
• 若要支持循环（如ForEach），还需实现buildArray方法，将数组中的PopupBodyView组合成容器视图。

内容的提问来源于stack exchange，提问作者linus_hologram