如何配置@PageBuilder兼容ForEach且遵循协议要求？

问题现象 #

• 单个PageX组件在NavX容器中可正常运行
• 使用ForEach动态生成PageX集合时，抛出如下错误：

Argument type 'ForEach<Range<Array.Index>, Range<Array.Index>.Element, PageX>' (aka 'ForEach<Range, Int, PageX>') does not conform to expected type 'PageXItem'

当前代码细节 #

NavX中@PageBuilder的定义 #

@PageBuilder private var content: () -> Content

期望的两种用法 #

单个PageX组件

NavX {
   PageX {
   }
}

动态生成PageX集合

NavX {
   ForEach(...) { _ in 
      PageX {...}
   }
}

当前的@PageBuilder实现（含无效尝试） #

@resultBuilder
public struct PageBuilder {

    /// Builds a collection of `PageXItem` views.
    ///
    /// - Parameter components: A variadic list of views conforming to `PageXItem`.
    /// - Returns: An array of views that conform to `PageXItem`.
    static public func buildBlock(_ components: any PageXItem...) -> [any PageXItem] {
        components
    }

    /// Builds a collection of `PageXItem` views, particularly useful for conditional view constructions.
    ///
    /// - Parameter components: A variadic list of arrays of views conforming to `PageXItem`.
    /// - Returns: An array of views that conform to `PageXItem`.
    static public func buildPartialBlock(_ components: [any PageXItem]...) -> [any PageXItem] {
        components.flatMap { $0 }
    }
    
    static public func buildFinalResult(_ component: [any PageXItem]) -> [any PageXItem] {
        component
    }
    
    static public func buildBlock<C: View>(_ component: ForEach<[any PageXItem], UUID, C>) -> ForEach<[any PageXItem], UUID, C> {
        component
    }
}

解决方案 #

问题出在你添加的最后一个buildBlock方法：它直接返回ForEach实例，但ForEach本身并不符合PageXItem协议，所以无法被PageBuilder处理。正确的做法是将ForEach生成的所有PageX组件转换为[any PageXItem]数组，让PageBuilder能识别并合并这些组件。

修改步骤 #

1. 删除你添加的那个返回ForEach的buildBlock方法
2. 添加以下泛型buildBlock方法，专门处理ForEach：

static public func buildBlock<Data: RandomAccessCollection, ID: Hashable>(_ component: ForEach<Data, ID, any PageXItem>) -> [any PageXItem] {
    component.data.map { component.content($0) }
}

说明 #

这个方法会遍历ForEach的数据源，调用其内容闭包生成每个PageX组件，最终返回一个PageXItem数组。这样PageBuilder就能把ForEach生成的动态集合和单个PageX组件统一处理，无论是单独使用ForEach还是混合单个组件都能正常工作。

如果你的ForEach使用的是indices（比如array.indices）或者非Identifiable元素，这个方法同样适用，因为它只要求数据源是RandomAccessCollection（ForEach的默认要求），且内容闭包返回PageXItem类型。

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