SwiftUI 自适应布局
概述
这是一项强化学科性的技能,用于构建响应可用空间而非设备假设的布局。涵盖工具选择、尺寸类限制、iOS 26 自由窗口以及常见的反模式。
核心原则: 无论苹果明天发布新设备,还是 iPadOS 明年增加新的多任务模式,你的布局都应能正常工作。响应你的容器,而不是你对设备的假设。
何时使用此技能
- “如何让这个布局在 iPad 和 iPhone 上都能正常工作?”
- “我应该使用 GeometryReader 还是 ViewThatFits?”
- “我的布局在分屏 / 台前调度下会崩溃”
- “尺寸类无法满足我的需求”
- “设计师希望竖屏和横屏有不同的布局”
- “为 iOS 26 窗口大小调整做准备”
决策树
“我需要我的布局适应...”
│
├─ 可用空间(容器驱动)
│ │
│ ├─ “选择最合适的变体”
│ │ → ViewThatFits
│ │
│ ├─ “在 H↔V 之间动画切换”
│ │ → AnyLayout + 条件判断
│ │
│ ├─ “读取尺寸进行计算”
│ │ → onGeometryChange (iOS 16+)
│ │
│ └─ “自定义布局算法”
│ → Layout 协议
│
├─ 平台特征
│ │
│ ├─ “紧凑 vs 常规宽度”
│ │ → horizontalSizeClass (⚠️ iPad 限制)
│ │
│ ├─ “辅助功能文本大小”
│ │ → dynamicTypeSize.isAccessibilitySize
│ │
│ └─ “平台差异”
│ → #if os() / Environment
│
└─ 窗口形状(宽高比)
│
├─ “横屏 vs 竖屏语义”
│ → Geometry + 自定义阈值
│
├─ “自动显示/隐藏列”
│ → NavigationSplitView (iOS 26 中自动处理)
│
└─ “窗口生命周期”
→ @Environment(\.scenePhase)
工具选择
快速决策
是否需要计算出的值(宽度、高度)?
├─ 是 → onGeometryChange
└─ 否 → 是否需要动画过渡?
├─ 是 → AnyLayout + 条件判断
└─ 否 → ViewThatFits
何时使用每种工具
| 我需要... | 使用这个 | 不要用这个 |
|---|---|---|
| 在 2-3 种布局变体中选择 | ViewThatFits | if size > X |
| 在 H↔V 之间动画切换 | AnyLayout | 条件判断 HStack/VStack |
| 读取容器尺寸 | onGeometryChange | GeometryReader |
| 适应辅助功能文本 | dynamicTypeSize | 固定断点 |
| 检测紧凑宽度 | horizontalSizeClass | UIDevice.idiom |
| 检测 iPad 上的窄窗口 | Geometry + 阈值 | 仅尺寸类 |
| 显示/隐藏侧边栏 | NavigationSplitView | 手动列逻辑 |
| 自定义布局算法 | Layout 协议 | 嵌套的 GeometryReader |
模式 1:ViewThatFits
何时使用: 你有 2-3 种布局变体,并希望 SwiftUI 选择第一个适合的。
ViewThatFits {
// 首选:水平布局
HStack {
Image(systemName: "star")
Text("收藏")
Spacer()
Button("添加") { }
}
// 备选:垂直布局
VStack {
HStack {
Image(systemName: "star")
Text("收藏")
}
Button("添加") { }
}
}
限制: ViewThatFits 不会暴露选择了哪个变体。如果你需要该状态用于其他视图,请改用 AnyLayout。
模式 2:用于动画切换的 AnyLayout
何时使用: 你需要布局之间的动画过渡,或者需要知道当前布局状态。
struct AdaptiveStack<Content: View>: View {
@Environment(\.horizontalSizeClass) var sizeClass
let content: Content
var layout: AnyLayout {
sizeClass == .compact
? AnyLayout(VStackLayout(spacing: 12))
: AnyLayout(HStackLayout(spacing: 20))
}
var body: some View {
layout {
content
}
.animation(.default, value: sizeClass)
}
}
对于动态类型:
@Environment(\.dynamicTypeSize) var dynamicTypeSize
var layout: AnyLayout {
dynamicTypeSize.isAccessibilitySize
? AnyLayout(VStackLayout())
: AnyLayout(HStackLayout())
}
模式 3:onGeometryChange(几何的首选)
何时使用: 你需要实际尺寸进行计算。比 GeometryReader 更受推荐。
struct ResponsiveGrid: View {
@State private var columnCount = 2
var body: some View {
LazyVGrid(columns: Array(repeating: GridItem(.flexible()), count: columnCount)) {
ForEach(items) { item in
ItemView(item: item)
}
}
.onGeometryChange(for: Int.self) { proxy in
max(1, Int(proxy.size.width / 150))
} action: { newCount in
columnCount = newCount
}
}
}
用于宽高比检测(iPad “方向”):
struct WindowShapeReader: View {
@State private var isWide = true
var body: some View {
content
.onGeometryChange(for: Bool.self) { proxy in
proxy.size.width > proxy.size.height * 1.2
} action: { newValue in
isWide = newValue
}
}
}
模式 4:GeometryReader(必要时使用)
何时使用: 你需要几何信息,并且运行在 iOS 15 或更早版本上,或者在布局阶段(不仅仅是作为副作用)需要几何信息。
// ✅ 正确:受约束的 GeometryReader
VStack {
GeometryReader { geo in
Text("宽度: \(geo.size.width)")
}
.frame(height: 44) // 必须约束高度!
Button("下一步") { }
}
// ❌ 错误:未受约束(贪婪)
VStack {
GeometryReader { geo in
Text("宽度: \(geo.size.width)")
}
// 占用所有可用空间,压扁兄弟视图
Button("下一步") { }
}
尺寸类真值表(iPad)
| 配置 | 水平方向 | 垂直方向 |
|---|---|---|
| 全屏竖屏 | .regular | .regular |
| 全屏横屏 | .regular | .regular |
| 70% 分屏 | .regular | .regular |
| 50% 分屏 | .regular | .regular |
| 33% 分屏 | .compact | .regular |
| Slide Over | .compact | .regular |
| 带键盘 | (不变) | (不变) |
关键见解: 尺寸类仅在 iPad 宽度约为 33% 或 Slide Over 时变为 .compact。如需更精细的控制,请使用几何信息。
iOS 26 自由窗口
变化内容
| iOS 26 之前 | iOS 26+ |
|---|---|
| 固定的分屏尺寸 | 自由拖拽调整大小 |
UIRequiresFullScreen 允许 | 已弃用 |
| iPad 上没有菜单栏 | 通过 .commands 提供菜单栏 |
| 手动列可见性 | NavigationSplitView 自动适配 |
Apple 的指导原则
“调整应用程序的大小不应永久改变其布局。尽可能抓住机会恢复到起始状态。”
翻译: 不要根据窗口大小保存布局状态。当窗口恢复到原始大小时,布局也应如此。
NavigationSplitView 自动适配
// iOS 26:列自动显示/隐藏
NavigationSplitView {
Sidebar()
} content: {
ContentList()
} detail: {
DetailView()
}
// 无需手动管理 columnVisibility
迁移清单
- 从 Info.plist 中移除
UIRequiresFullScreen - 在任意窗口大小(不仅仅是 33/50/66%)下测试
- 验证布局在调整大小后不会“卡住”
- 为常见操作添加菜单栏命令
- 测试窗口控制不会与工具栏项重叠
反模式
❌ 设备方向观察者
// ❌ 错误:报告的是设备,而不是窗口
NotificationCenter.default.addObserver(
forName: UIDevice.orientationDidChangeNotification, ...
)
let orientation = UIDevice.current.orientation
if orientation.isLandscape { ... }
为什么失败: 报告的是物理设备方向,而不是窗口形状。在分屏、台前调度、iOS 26 中均不正确。
修复: 使用 onGeometryChange 读取实际窗口尺寸。
❌ 屏幕边界
// ❌ 错误:返回的是整个屏幕,而不是你的窗口
let width = UIScreen.main.bounds.width
if width > 700 { useWideLayout() }
为什么失败: 在多任务处理中,你的应用程序可能只占屏幕的 40%。
修复: 读取视图的实际容器大小。
❌ 设备型号检查
// ❌ 错误:在新设备上会失效,在多任务中也会出错
if UIDevice.current.userInterfaceIdiom == .pad {
useWideLayout()
}
为什么失败: 处于 1/3 分屏模式的 iPad 比横屏的 iPhone 14 Pro Max 还要窄。
修复: 响应可用空间,而不是设备身份。
❌ 未受约束的 GeometryReader
// ❌ 错误:GeometryReader 是贪婪的
VStack {
GeometryReader { geo in
Text("尺寸: \(geo.size)")
}
Button("下一步") { } // 被压扁
}
修复: 使用 .frame() 进行约束,或者改用 onGeometryChange。
❌ 将尺寸类作为方向代理
// ❌ 错误:iPad 在两个方向都是 .regular
var isLandscape: Bool {
horizontalSizeClass == .regular // 在 iPad 上始终为 true!
}
修复: 如果需要宽高比,请根据实际几何信息计算。
压力场景
“设计师想要 iPhone 特定的布局”
诱惑: if UIDevice.current.userInterfaceIdiom == .phone
回应: “我会将这些实现为‘紧凑’和‘常规’布局,根据可用空间进行切换。当窗口较窄时,iPhone 布局也会出现在 iPad 上。这为我们以后支持台前调度和 iOS 26 提供了保障。”
“就用 GeometryReader 吧,没问题”
诱惑: 把所有东西都包在 GeometryReader 里。
回应: “GeometryReader 有已知的布局副作用——它会贪婪地扩展。onGeometryChange 读取相同的数据但不会影响布局。它向后兼容到 iOS 16。”
“尺寸类以前工作得很好”
诱惑: 强制一切通过尺寸类。
回应: “尺寸类是粗粒度的。iPad 在两个方向上都是 .regular。我会使用尺寸类来处理大类,对于精确阈值则使用几何信息。”
“我们不支持 iPad 多任务”
诱惑: UIRequiresFullScreen = true
回应: “苹果在 iOS 26 中弃用了全屏模式。即使没有积极支持分屏,应用程序在调整大小时也不能崩溃。基于空间的布局成本一样。”
资源
WWDC: 2025-208, 2024-10074, 2022-10056
相关技能: axiom-swiftui-layout-ref, axiom-swiftui-debugging, axiom-liquid-glass