用途:该技能负责 SwiftUI 中常规的堆栈、网格、列表、滚动视图、表单、控件、搜索 UI 与浮层布局选择。裁剪、意外重叠、键盘遮挡及窗口尺寸、方向、Dynamic Type、本地化适配交由 swiftui-responsive-layout;状态归属、导航与模态策略、手势、动画、性能问题分别交由对应技能。
主要能力与选择建议:小型固定排布用 VStack、HStack、ZStack;单轴大集合用 ScrollView 配 LazyVStack 或 LazyHStack;自适应二维集合用 LazyVGrid 或 LazyHGrid;需要平台列表行为、分组、编辑、滑动操作时用 List;结构化设置或数据输入用 Form;标准容器不足时再用 Layout 协议或几何 API。不要仅按行数选择容器,需考虑编辑行为、选择、分组语义、分隔线、自定义背景与嵌套交互。
标识与惰性:动态项需在插入、删除、排序、过滤后仍稳定的标识,优先模型标识;仅当位置即固定集合的标识时才可用索引。集合足够大时用惰性容器,避免把每个小堆栈都包成惰性;昂贵的过滤、排序、格式化、图像处理应放在逐帧布局闭包之外。
列表、表单与控件:需要系统编辑、选择、滑动操作、分组或平台行行为时用 List,视觉或交互明显不同时用 ScrollView 加惰性堆栈。Form 用于结构化输入与设置,校验与持久化策略不要写进布局代码。交互行需足够点击区域与有效 contentShape,并保留 Dynamic Type、允许回流而非截断关键内容。
搜索与浮层:用 .searchable 呈现平台搜索,查询状态归功能所有者,仅当搜索工作与视图生命周期绑定时用 .task(id:)。浮层用于不影响布局的临时 UI,需明确对齐、过渡、无障碍播报与关闭归属。
滚动驱动效果:用单一归一化进度值驱动连续效果,几何观察放在尽可能窄的子树;避免可能相互矛盾的并行布尔值。
常见错误与限制:在可滚动容器内写死高度导致小屏裁剪;同轴嵌套两个 ScrollView;惰性网格每格都用 GeometryReader 造成布局抖动;对透明背景行缺少 .contentShape(Rectangle()) 导致点击失效。使用带版本修饰符前须检查部署目标、Swift 模式与 SDK,除非用户要求否则保留项目设置。具体版本要求与 API 细节暂未提供。