SuperAPI AI 工具集

swiftui-navigation

通用与其它

查看项目

更新于 10-16 05:53

技能介绍

用途:为 SwiftUI 应用实现导航与路由模式,面向 iOS 26+、Swift 6.3,多数模式向后兼容 iOS 17。

主要能力:

  1. NavigationStack 推入式导航:用 Hashable 枚举定义 Route,配合 [Route] 绑定与 .navigationDestination(for:) 实现编译期检查的编程式跳转(append 推入、removeLast 弹出、置空回根)。仅在同一栈需容纳异构路由类型时使用 NavigationPath。复杂应用可用 router 对象持有路径与 sheet 状态,经 .environment() 按标签注入。
  2. NavigationSplitView:用于 iPad/Mac 的侧栏-详情多列布局,iPhone 回退为栈导航;如需非标准额外列,可手动 HStack 分列并检查 horizontalSizeClass。
  3. Sheet 呈现:状态代表模型时优先 .sheet(item:),sheet 内部自行 dismiss;iOS 18+ 可用 .presentationSizing(.form/.page/.fitted/.automatic) 控制尺寸,.fitted/.sticky 微调轴向;未保存变更用 .interactiveDismissDisabled,macOS 15+ 可用 .dismissalConfirmationDialog。
  4. 标签页导航:用 Tab(value:) 配合 selection 绑定,每个标签独立包裹 NavigationStack;iOS 26 新增搜索标签、tabViewSearchActivation、tabBarMinimizeBehavior(仅 iPhone)、tabViewSidebarHeader/Footer、tabViewBottomAccessory、TabSection 等。
  5. 深度链接:遵循解析→校验→提交,先解析成类型化路由再原子更新标签与路径。通用链接需 AASA 文件与 Associated Domains 权限,自定义 scheme 在 Info.plist 注册 CFBundleURLTypes,统一用 .onOpenURL 处理;可用 .userActivity() 与 .onContinueUserActivity() 支持 Handoff。

限制与常见错误:不要使用已弃用的 NavigationView;不要在标签间共享同一路径;路由数据须轻量且 Hashable;避免嵌套 @Observable router;router 类需 @MainActor 以满足 Swift 6 并发安全。

资料未提供具体安装方式或依赖配置。