SwiftUI编程式导航实现：跳转至指定Thing详情页

SwiftUI 场景 #

1. 处理通知点击事件 #

首先在通知代理中捕获点击动作，提取Thing的唯一标识（比如ID）：

UNUserNotificationCenter.current().delegate = self

func userNotificationCenter(_ center: UNUserNotificationCenter, didReceive response: UNNotificationResponse, withCompletionHandler completionHandler: @escaping () -> Void) {
    let userInfo = response.notification.request.content.userInfo
    guard let thingId = userInfo["thingId"] as? String else {
        completionHandler()
        return
    }
    // 触发导航逻辑
    NavigationRouter.shared.navigateToThingDetail(with: thingId)
    completionHandler()
}

2. 全局导航状态管理 #

用可观察对象维护导航路径，实现跳转逻辑：

class NavigationRouter: ObservableObject {
    static let shared = NavigationRouter()
    @Published var path = NavigationPath()
    
    func navigateToThingDetail(with thingId: String) {
        // 从数据源获取对应Thing实例
        if let targetThing = YourThingDataSource.getThing(by: thingId) {
            path.append(targetThing)
        }
    }
    
    func popToList() {
        // 回到列表页，可根据实际层级调整
        path.removeLast(path.count)
    }
}

3. 绑定导航栈与目标页面 #

在根视图中通过NavigationStack绑定路径，指定导航目标：

@main
struct YourApp: App {
    @StateObject private var router = NavigationRouter.shared
    
    var body: some Scene {
        WindowGroup {
            NavigationStack(path: $router.path) {
                ThingListView()
                    .navigationDestination(for: Thing.self) { thing in
                        ThingDetailView(targetThing: thing, router: router)
                    }
            }
        }
    }
}

4. 自定义返回按钮（可选） #

默认导航栏自带返回按钮，若需自定义样式/文字：

struct ThingDetailView: View {
    let targetThing: Thing
    let router: NavigationRouter
    
    var body: some View {
        VStack {
            // 展示Thing详情内容
            Text("Thing 详情：\(targetThing.name)")
        }
        .navigationTitle("Thing 详情")
        .navigationBarBackButtonHidden(true)
        .toolbar {
            ToolbarItem(placement: .navigationBarLeading) {
                Button("返回列表") {
                    router.popToList()
                }
            }
        }
    }
}

UIKit 场景 #

1. 通知点击跳转逻辑 #

在通知代理中获取当前导航控制器，推送详情页：

func userNotificationCenter(_ center: UNUserNotificationCenter, didReceive response: UNNotificationResponse, withCompletionHandler completionHandler: @escaping () -> Void) {
    let userInfo = response.notification.request.content.userInfo
    guard let thingId = userInfo["thingId"] as? String else {
        completionHandler()
        return
    }
    
    // 获取当前根导航控制器
    guard let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene,
          let rootNav = windowScene.windows.first?.rootViewController as? UINavigationController,
          let targetThing = YourThingDataSource.getThing(by: thingId) else {
        completionHandler()
        return
    }
    
    // 推送详情页
    let detailVC = ThingDetailViewController(thing: targetThing)
    rootNav.pushViewController(detailVC, animated: true)
    completionHandler()
}

2. 配置详情页返回按钮 #

UIKit导航栏默认带返回按钮，若需自定义：

class ThingDetailViewController: UIViewController {
    private let targetThing: Thing
    
    init(thing: Thing) {
        self.targetThing = thing
        super.init(nibName: nil, bundle: nil)
    }
    
    required init?(coder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }
    
    override func viewDidLoad() {
        super.viewDidLoad()
        view.backgroundColor = .white
        
        // 自定义返回按钮
        navigationItem.leftBarButtonItem = UIBarButtonItem(
            title: "返回列表",
            style: .plain,
            target: self,
            action: #selector(popToList)
        )
    }
    
    @objc private func popToList() {
        navigationController?.popViewController(animated: true)
    }
}

核心注意事项 #

• 通知推送时，必须在userInfo中携带Thing的唯一标识（如ID），否则无法定位目标实例
• 确保你的数据源（YourThingDataSource）能通过ID正确获取对应的Thing对象
• SwiftUI中需保证NavigationStack的路径泛型与Thing类型匹配，否则无法触发导航

内容的提问来源于stack exchange，提问作者nth-chile