SuperAPI AI 工具集

axiom-swiftui-nav-ref

通用与其它

查看项目

更新于 10-15 20:11

技能介绍

用途:为 SwiftUI 导航实现提供参考,涵盖 NavigationStack(iOS 16+)、NavigationSplitView(iOS 16+)、NavigationPath、深度链接、状态恢复与 Tab 集成。

主要能力:数据驱动导航,用 NavigationPath 表示栈状态,支持程序化 push/pop 与深度链接;多列布局,NavigationSplitView 自动适配(iPad 三列到 iPhone 单栈);状态恢复,Codable NavigationPath 配合 SceneStorage 跨启动持久化;Tab 集成,每个 Tab 独立 NavigationStack 并在切换时保留状态(iOS 18+);iOS 26+ 的 Liquid Glass 导航栏、侧边栏与工具栏。

使用方式:以 path 绑定、值型 NavigationLink 与 navigationDestination(for:) 构成核心模式;navigationDestination 需放在惰性容器外,且每种数据类型只注册一次,不可与 NavigationLink(destination:) 混用。深度链接用 .onOpenURL 解析 URL 后操作 path。状态恢复存储 ID 而非完整对象,用 compactMap 处理已删除项。搜索角色 Tab 的内容必须包在 NavigationStack 中并应用 .searchable()。

适用场景:新应用、多平台、较简单的导航流程;复杂协调器模式或遗留代码可考虑 UIKit。

限制:NavigationView 自 iOS 16 起弃用;部分 API 需 iOS 18 或 iOS 26+。具体收费、平台与效果资料未提供。