SuperAPI AI 工具集

swiftui-layout-components

通用与其它

查看项目

更新于 10-15 21:12

技能介绍

用途:为 SwiftUI 应用提供布局与组件模式,面向 iOS 26+ 与 Swift 6.3,多数模式标注可向后兼容至 iOS 17;涉及布局选型时先说明容器与约束,动画时序交给 swiftui-animation 技能,模态路由与 sheet 交给 swiftui-navigation 技能。

主要能力:堆栈方面,小量固定内容用 VStack/HStack/ZStack,大量或动态集合在 ScrollView 中用 LazyVStack/LazyHStack 按需创建子视图。网格用 LazyVGrid,.adaptive 列自适应设备,.flexible 列固定列数,用 .aspectRatio 控制单元格尺寸。列表用 List 与 Section,.plain 用于信息流、.insetGrouped 用于设置,支持 .refreshable 下拉刷新、.contentShape(Rectangle())、自定义背景与行分隔。ScrollView 支持 ScrollPosition 声明式滚动定位、.scrollTargetLayout()、safeAreaInset(edge:),iOS 26 新增 .scrollEdgeEffectStyle、.backgroundExtensionEffect()、.safeAreaBar(edge:)。表单用 Form 分组控件,控件包括 Toggle、Picker、Slider、DatePicker、TextField,绑定 @State、@Binding 或 @AppStorage。搜索用 .searchable 配合 .searchScopes 与 .task(id:) 防抖。覆盖层用 .overlay(alignment:) 加过渡与自动消失计时。

限制与常见错误:惰性容器内不要放 GeometryReader,需要尺寸时用 .onGeometryChange;ForEach 用稳定 Identifiable ID,避免数组下标;同轴嵌套滚动会冲突;大型或可展开的 List 行应改用 ScrollView + LazyVStack;选项多时不要用 .segmented;未指定间距时省略 stack/grid spacing 以使用平台自适应默认值;滚动显现用一个归一化进度值驱动。该技能未提供收费与价格信息。