SwiftUI 界面模式
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/sundial-org-awesome-openclaw-skills-swiftui-ui-patterns。
技能介绍
常见卡点
在已有 SwiftUI 工程里加一块新界面,很容易在状态放在哪、NavigationStack 和 TabView 怎么接、Sheet 用 isPresented 还是 item 上反复试探。新建工程时若没有统一的 Tab + 路由 + 弹层骨架,后面每加一个页面就要改一堆调用点。
技能怎么用
技能把路径拆成两条:现有项目先按交互形态(列表、详情、编辑、设置、分栏)定屏幕,再用 rg "TabView(" 之类在仓库里找最近似示例,对照 references/components-index.md 选组件说明;新项目从 references/app-scaffolding-wiring.md 起步,用骨架里的 AppTab、RouterPath 把 TabView、NavigationStack 和 sheet 先接好。
通用约定强调现代 SwiftUI 状态(@State、@Binding、@Observable、@Environment),少堆 ViewModel;视图拆小、用 .task 做异步并显式处理 loading/error。新建视图时按六步:定状态归属 → 环境依赖 → 层级与子视图 → 异步加载 → 无障碍 → 编译与调用点。Sheet 优先 .sheet(item:),弹层内部自己 dismiss(),少通过 onCancel/onConfirm 往外传。
边界与注意
主要服务「按本仓库约定写 SwiftUI」;维护遗留文件时可保留旧模式。组件文档需自行维护 references/*.md 并回写索引,技能不替代 Apple 官方 API 参考。
使用场景
- 在维护中的 SwiftUI App 里新增设置页,需要与现有 TabView 和导航栈风格一致
- 接手他人仓库写列表到详情流,要在代码库里用 ripgrep 找最近似的 View 再改
- 从零搭新 App,要先接好 TabView、NavigationStack 和路由枚举再逐屏加功能
- 弹层选型混乱时,要把选中模型驱动的 `.sheet(item:)` 和 dismiss 职责写清楚
适合人员
- 负责 iOS 客户端迭代的工程师,要在老工程里按仓库约定加新界面而不引入多余 ViewModel
- 刚接手 SwiftUI 开源或内部项目的维护者,需要靠 components-index 对齐 Tab/导航/Sheet 写法
- 准备新开 SwiftUI 产品的技术负责人,想先用脚手架文档固定路由与弹层再分工做页面
- 写组件参考或内部分享的 iOS 开发者,要按技能模板增补 `references/*.md` 并链到真实示例文件