SwiftUI-Agent-Skill 导航指南NavigationStack、Sheet 与类型安全导航的 9 个模式【免费下载链接】SwiftUI-Agent-SkillAdd expert SwiftUI Best Practices guidance to your AI coding tool (Agent Skills open format).项目地址: https://gitcode.com/gh_mirrors/sw/SwiftUI-Agent-SkillSwiftUI-Agent-Skill是一个开源的 AI 编程助手技能包它为支持 Agent Skills 开放格式的 AI 编码工具提供专家级 SwiftUI 最佳实践指导。本导航指南聚焦其中最受关注的部分——NavigationStack 类型安全导航、Sheet 弹窗模式与 NavigationSplitView 多栏布局帮你快速掌握 9 个经过实战验证的导航模式让 AI 助手写出的 SwiftUI 代码更正确、更易维护。 本指南的核心内容来自参考文件sheet-navigation-patterns.md技能入口见 SKILL.md。快速上手这个技能包能帮你做什么SwiftUI-Agent-Skill 把大量 SwiftUI 实战经验浓缩为 30 份主题化参考文档见 README.md 中的 Whats Inside 章节覆盖状态管理、视图组合、性能、导航、动画、Liquid Glass 等主题。AI 助手会按需加载对应文档例如当你提到导航或Sheet时它会自动进入 sheet-navigation-patterns.md 查找规范。想安装直接查看 INSTALLATION.md支持多种 AI 工具的一键安装方式。9 个导航模式从 Sheet 到多栏布局模式 1用.sheet(item:)呈现模型驱动的弹窗 ✅推荐当弹窗展示的是某个数据模型时用.sheet(item:)而不是.sheet(isPresented:)。一个可选值Item?就能同时控制是否显示和显示哪个天然避免两个状态不同步的 bug弹窗体内自动解包无需if let关闭时自动置回nil逻辑极简模式 2让 Sheet 自己管理关闭与操作好的 Sheet 应该自给自足内部通过Environment(\.dismiss)完成关闭在自身工具栏里放取消/保存按钮。❌ 避免从父视图传入onSave/onCancel回调——这会制造层层回调传递prop-drilling降低可复用性✅ 推荐Sheet 视图持有自己的State草稿完成操作后自行关闭模式 3用枚举统一管理多个 Sheet当页面可能弹出新建 / 编辑 / 分类等多个不同弹窗时与其声明 N 个布尔值 N 个.sheet修饰符不如定义一个遵循Identifiable的枚举enum Sheet: Identifiable { case add, edit(Article), categories }一个State 一个.sheet(item:)即可天然保证同一时刻只弹一个窗。模式 4NavigationStack 类型安全导航 SwiftUI 现代导航的核心组合NavigationLink(value:)navigationDestination(for:)。定义一个Hashable的路由枚举如enum Route { case profile, settings }每个destination用switch匹配路由并返回对应视图编译器帮你保证每个路由都有对应视图改错直接报错——这就是类型安全导航的威力模式 5用 NavigationPath 编程式导航声明式NavigationLink之外把NavigationPath绑定到State上就能在按钮、网络回调等任意时机append路由跳转保存/恢复导航状态返回到指定层级配合路由枚举实现深链式跳转模式 6NavigationSplitView 两栏布局侧边栏驱动macOS 和 iPad 应用的标准形态左侧List(selection:)侧边栏右侧detail展示详情。选中项为nil时用ContentUnavailableView给出友好的空态提示侧边栏只需绑定一个可选 IDSwiftUI 自动处理选中态模式 7NavigationSplitView 三栏布局对于部门 → 员工 → 详情这类层级数据提供sidebar / content / detail三栏。几个常用配置修饰符修饰符作用columnVisibility:控制列的显示.all/.doubleColumn/.detailOnly.navigationSplitViewColumnWidth(min:ideal:max:)设置每栏宽度preferredCompactColumn:窄屏时优先展示哪一栏.navigationSplitViewStyle(.balanced)切换分栏样式 小贴士不同平台的折叠行为由尺寸类而非设备型号决定——iPhone Duo 的内屏也可能提供 regular 宽度上下文多栏可以同时出现。模式 8Inspector 检查器面板iOS 17 / macOS 14Inspector 是尾边补充信息面板自动适应平台macOS / iPad 横屏 → 显示为右侧可拖拽的列iPhone 紧凑宽度 → 自动降级为 Sheet支持下滑关闭用.inspectorColumnWidth(300)或(min:ideal:max:)控制宽度配合InspectorCommands可免费获得默认键盘切换快捷键模式 9展示类修饰符与 SDK 27 物品驱动对话框其余常见弹窗形态的选型建议.fullScreenCover沉浸式全屏地图、播放器.popover上下文气泡iPhone 上可用.presentationCompactAdaptation(.popover)保持气泡形态SDK 27 新增alert(_:item:)与confirmationDialog(_:item:)物品驱动重载——可选值本身驱动显示与内容无需再同步一个布尔标志且向下兼容部署到 iOS 15模式速查清单 模型驱动的弹窗一律用.sheet(item:)Sheet 内部自管dismiss不接收父级回调多个弹窗用Identifiable枚举 单个.sheet(item:)NavigationStacknavigationDestination(for:)做类型安全导航需要编程跳转时用NavigationPath侧边栏应用选NavigationSplitView两栏或三栏补充信息面板用.inspector可选值驱动的告警/确认框优先用 SDK 27 的item:重载完整清单见 sheet-navigation-patterns.md 末尾的 Summary Checklist。延伸阅读技能包中的相关参考主题参考文件导航与 Sheet本文来源sheet-navigation-patterns.md滚动与程序化定位scroll-patterns.md状态管理与数据流state-management.md主题路由总表Topic RouterSKILL.md把这份指南的思路交给你的 AI 编码助手或直接安装 SwiftUI-Agent-Skill 让它自动遵循——你写的每一条导航代码都会离专家水准更近一步 【免费下载链接】SwiftUI-Agent-SkillAdd expert SwiftUI Best Practices guidance to your AI coding tool (Agent Skills open format).项目地址: https://gitcode.com/gh_mirrors/sw/SwiftUI-Agent-Skill创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考