SwiftUI アダプティブレイアウト は何をしますか?
概要
デバイスの想定ではなく、利用可能なスペースに応答するレイアウトを構築するための規律を強化するスキルです。ツールの選択、サイズクラスの制限、iOS 26の自由形式ウィンドウ、および一般的なアンチパターンをカバーします。
核となる原則: あなたのレイアウトは、Appleが明日新しいデバイスを出荷したり、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)
}
}
Dynamic Typeの場合:
@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("次へ") { }
}
サイズクラス Truth Table(iPad)
| 設定 | 水平 | 垂直 |
|---|---|---|
| 全画面ポートレート | .regular | .regular |
| 全画面ランドスケープ | .regular | .regular |
| 70% 分割ビュー | .regular | .regular |
| 50% 分割ビュー | .regular | .regular |
| 33% 分割ビュー | .compact | .regular |
| スライドオーバー | .compact | .regular |
| キーボード表示時 | (変更なし) | (変更なし) |
重要な洞察: サイズクラスがiPadで.compactになるのは、幅が約33%またはスライドオーバーの場合のみです。より細かい制御が必要な場合は、ジオメトリを使用してください。
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
対応: 「AppleはiOS 26でフルスクリーンのみを非推奨にしました。アクティブな分割ビューのサポートがなくても、アプリはリサイズ時に壊れてはいけません。スペースベースのレイアウトは同じコストです。」
リソース
WWDC: 2025-208, 2024-10074, 2022-10056
スキル: axiom-swiftui-layout-ref, axiom-swiftui-debugging, axiom-liquid-glass