SwiftUI 4 List初始化器在iOS平台不可用问题咨询

这个问题非常普遍，大量升级Xcode 14及以上版本的开发者都碰到过相同的编译报错，根本原因和解决方法如下：

• 直接传入数据集合、带selection参数的List初始化器是仅macOS平台可用的API，iOS平台从未支持过该调用方式。
• 旧版本Xcode能正常编译这类代码，是因为早期SwiftUI SDK的跨平台可用性标注存在遗漏，苹果从Xcode 14（对应iOS 16 SDK）开始补全了该API的平台限制，因此旧代码会直接抛出'init(_:selection:rowContent:)' is unavailable in iOS的编译错误。
• 你尝试的List套ForEach写法依然报错，基本是两个常见问题导致：一是selection绑定的类型和列表元素的ID类型不匹配，二是没有给列表行设置和ID对应的tag修饰符。

iOS平台实现带选中能力的List，必须在List内部嵌套ForEach加载数据，同时保证绑定类型、行标签的匹配，分两种常见场景：

单选场景（比如标签页切换、侧边栏导航） #

单选场景下selection绑定必须是和元素ID类型一致的可选值，同时给每一行打上对应ID的tag：

// 示例1：Tab遵循Identifiable协议的场景
@State private var lastTab: Tab.ID? // 必须为可选类型，类型和元素ID完全匹配

List(selection: $lastTab) {
    ForEach(tabs) { tab in
        TabRowView(tab: tab)
            .tag(tab.id) // 必须设置tag，值与当前行元素ID一致
    }
}

如果是基础类型数组（比如字符串、整数数组），用\.self作为ID即可，tag直接绑定元素本身：

// 示例2：基础类型数组场景
let tabs = ["首页", "发现", "我的"]
@State private var lastTab: String? // 可选类型，和数组元素类型一致

List(selection: $lastTab) {
    ForEach(tabs, id: \.self) { tab in
        Text(tab)
            .tag(tab)
    }
}

多选场景 #

多选场景下selection绑定必须是元素ID类型的Set集合，通常搭配编辑模式使用：

@State private var selectedTabs: Set<Tab.ID> = [] // 必须为Set类型

List(selection: $selectedTabs) {
    ForEach(tabs) { tab in
        Text(tab.title)
            .tag(tab.id)
    }
}
.environment(\.editMode, .constant(.active)) // 开启编辑模式才会显示多选勾选控件

• 不要尝试在iOS端用直接传集合给List+selection的写法，该API仅支持macOS，后续版本也不会在iOS开放
• 单选场景如果把selection绑定设为非可选类型，会直接触发初始化器不匹配的编译错误
• 不管单选还是多选，缺省行tag修饰符会导致选中状态完全无法同步，不会有编译报错但功能异常，这点很容易漏
• 如果ForEach用了id:\.self，行的tag必须直接传元素本身，不能传其他属性值

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