SwiftUI中navigationDestination多参数传递实现方法咨询

问题场景 #

我正在熟悉SwiftUI全新的Navigation框架，发现网上几乎所有示例里navigationDestination都只用单个参数，比如官方文档的这段代码：

NavigationStack {
    List(parks) { park in
        NavigationLink(park.name, value: park)
    }
    .navigationDestination(for: Park.self) { park in // <-- 此处
        ParkDetails(park: park) // <-- 以及此处
    }
}

但我的ParkDetails需要接收多个参数，比如ParkDetails(park: park, updateThumbnail: true)，有没有可靠简便的实现方式？用元组(Park, Bool)可行吗？

另外我之前用旧写法完全没问题：

NavigationLink(destination: ParkDetails(park: park, updateThumbnail: true)) {
    // 链接内容
}

还有个问题：如果以后需要传15个不同参数（部分可选），难道要写一大堆不同的.navigationDestination()吗？

解决方案 #

1. 包装成自定义数据类型（推荐） #

别用元组，直接定义专门的结构体封装所有跳转参数，类型清晰、扩展性强，后续加参数只需修改结构体：

// 定义跳转参数结构体（需遵循Hashable）
struct ParkDetailsParams: Hashable {
    let park: Park
    let updateThumbnail: Bool
    // 后续新增参数直接在这里添加，比如可选描述
    let extraDescription: String?
}

// 使用方式
NavigationStack {
    List(parks) { park in
        NavigationLink("查看详情", value: ParkDetailsParams(
            park: park, 
            updateThumbnail: true, 
            extraDescription: nil
        ))
    }
    .navigationDestination(for: ParkDetailsParams.self) { params in
        ParkDetails(
            park: params.park, 
            updateThumbnail: params.updateThumbnail
        )
    }
}

这种方式比元组可读性高得多，符合Swift类型安全原则，参数再多也只需要维护一个结构体和一个navigationDestination。

2. 继续使用旧版NavigationLink写法 #

如果你的场景不需要NavigationStack的路径管理能力（比如编程式跳转、路径持久化），直接用你之前的写法完全没问题——SwiftUI并没有废弃这种方式，它依然是合法且简便的方案：

NavigationStack {
    List(parks) { park in
        NavigationLink {
            ParkDetails(park: park, updateThumbnail: true)
        } label: {
            Text(park.name)
        }
    }
}

这种写法无需处理value和navigationDestination，直接指定目标页面，参数想传多少传多少，适合简单场景。

3. 利用环境变量传递全局通用参数 #

如果某些参数是全局共享的（比如用户信息、主题设置），可以把它们放到Environment中，避免重复传递：

// 定义环境键
struct UpdateThumbnailKey: EnvironmentKey {
    static let defaultValue: Bool = false
}

extension EnvironmentValues {
    var updateThumbnail: Bool {
        get { self[UpdateThumbnailKey.self] }
        set { self[UpdateThumbnailKey.self] = newValue }
    }
}

// 使用时
NavigationStack {
    List(parks) { park in
        NavigationLink(park.name, value: park)
            .environment(\.updateThumbnail, true) // 注入环境变量
    }
    .navigationDestination(for: Park.self) { park in
        ParkDetails(park: park)
    }
}

// 在ParkDetails中读取环境变量
struct ParkDetails: View {
    let park: Park
    @Environment(\.updateThumbnail) private var updateThumbnail
    
    var body: some View {
        // 直接使用updateThumbnail参数
        Text(park.name)
        if updateThumbnail {
            // 执行缩略图更新逻辑
        }
    }
}

这种方式适合减少重复传递的通用参数，和自定义结构体配合使用效果更佳。

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