SwiftUI 적응형 레이아웃
개요
디바이스 가정이 아닌 사용 가능한 공간에 반응하는 레이아웃을 구축하기 위한 규율을 강화하는 스킬입니다. 도구 선택, 크기 클래스 제한, iOS 26 자유형 창 및 일반적인 안티 패턴을 다룹니다.
핵심 원칙: 내일 애플이 새 기기를 출시하거나 내년에 iPadOS에 새로운 멀티태스킹 모드가 추가되어도 레이아웃이 올바르게 작동해야 합니다. 디바이스에 대한 가정이 아닌 컨테이너에 반응하세요.
이 스킬을 사용해야 할 때
- "이 레이아웃을 iPad와 iPhone에서 모두 작동하게 하려면?"
- "GeometryReader를 써야 할까, ViewThatFits를 써야 할까?"
- "Split View / Stage Manager에서 레이아웃이 깨져요"
- "크기 클래스가 필요한 정보를 제공하지 않아요"
- "디자이너가 세로 방향과 가로 방향에 따라 다른 레이아웃을 원해요"
- "iOS 26 창 크기 조절을 위한 앱 준비"
의사 결정 트리
"레이아웃을 적응시켜야 합니다..."
│
├─ 사용 가능한 공간(컨테이너 기반)에 따라
│ │
│ ├─ "가장 잘 맞는 변형 선택"
│ │ → ViewThatFits
│ │
│ ├─ "H↔V 간 애니메이션 전환"
│ │ → AnyLayout + 조건
│ │
│ ├─ "계산을 위해 크기 읽기"
│ │ → onGeometryChange (iOS 16+)
│ │
│ └─ "커스텀 레이아웃 알고리즘"
│ → Layout 프로토콜
│
├─ 플랫폼 특성에 따라
│ │
│ ├─ "Compact vs Regular 너비"
│ │ → 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 | 고정된 중단점 |
| Compact 너비 감지 | horizontalSizeClass | UIDevice.idiom |
| iPad에서 좁은 창 감지 | Geometry + 임계값 | 크기 클래스 단독 |
| 사이드바 표시/숨기기 | NavigationSplitView | 수동 열 로직 |
| 커스텀 레이아웃 알고리즘 | Layout 프로토콜 | 중첩된 GeometryReader |
패턴 1: ViewThatFits
사용 시기: 2-3개의 레이아웃 변형이 있고 SwiftUI가 처음으로 맞는 것을 선택하도록 하려는 경우.
ViewThatFits {
// 첫 번째 선택: 가로
HStack {
Image(systemName: "star")
Text("Favorite")
Spacer()
Button("Add") { }
}
// 대체: 세로
VStack {
HStack {
Image(systemName: "star")
Text("Favorite")
}
Button("Add") { }
}
}
제한 사항: 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("Width: \(geo.size.width)")
}
.frame(height: 44) // 반드시 제한!
Button("Next") { }
}
// ❌ 잘못됨: 제한 없음(탐욕적)
VStack {
GeometryReader { geo in
Text("Width: \(geo.size.width)")
}
// 모든 사용 가능한 공간을 차지하며 형제 뷰를 누름
Button("Next") { }
}
크기 클래스 진리표 (iPad)
| 구성 | 가로 | 세로 |
|---|---|---|
| 전체 화면 세로 | .regular | .regular |
| 전체 화면 가로 | .regular | .regular |
| 70% Split View | .regular | .regular |
| 50% Split View | .regular | .regular |
| 33% Split View | .compact | .regular |
| Slide Over | .compact | .regular |
| 키보드 사용 시 | (변화 없음) | (변화 없음) |
핵심 통찰: 크기 클래스는 iPad에서 약 33% 너비 또는 Slide Over에서만 .compact가 됩니다. 더 세밀한 제어가 필요하면 기하학 정보를 사용하세요.
iOS 26 자유형 창
변경 사항
| iOS 26 이전 | iOS 26+ |
|---|---|
| 고정된 Split View 크기 | 자유형 드래그하여 크기 조절 |
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 { ... }
실패 이유: 물리적 기기 방향을 보고하며 창 모양을 보고하지 않습니다. Split View, Stage Manager, iOS 26에서 잘못됩니다.
수정: onGeometryChange를 사용하여 실제 창 치수를 읽으세요.
❌ 화면 경계
// ❌ 잘못됨: 전체 화면을 반환하며 사용자의 창이 아님
let width = UIScreen.main.bounds.width
if width > 700 { useWideLayout() }
실패 이유: 멀티태스킹에서 앱은 화면의 40%만 가질 수 있습니다.
수정: 뷰의 실제 컨테이너 크기를 읽으세요.
❌ 기기 모델 확인
// ❌ 잘못됨: 새 기기에서 깨지며 멀티태스킹에서 오작동
if UIDevice.current.userInterfaceIdiom == .pad {
useWideLayout()
}
실패 이유: 1/3 Split View의 iPad는 iPhone 14 Pro Max 가로 방향보다 좁습니다.
수정: 기기 식별이 아닌 사용 가능한 공간에 반응하세요.
❌ 제한 없는 GeometryReader
// ❌ 잘못됨: GeometryReader는 탐욕적
VStack {
GeometryReader { geo in
Text("Size: \(geo.size)")
}
Button("Next") { } // 눌림
}
수정: .frame()으로 제한하거나 onGeometryChange를 사용하세요.
❌ 크기 클래스를 방향 프록시로 사용
// ❌ 잘못됨: iPad는 두 방향 모두 .regular
var isLandscape: Bool {
horizontalSizeClass == .regular // iPad에서는 항상 참!
}
수정: 화면 비율이 필요하면 실제 기하학 정보에서 계산하세요.
압박 시나리오
"디자이너가 iPhone 전용 레이아웃을 원해요"
유혹: if UIDevice.current.userInterfaceIdiom == .phone
응답: "이것들을 'compact'와 'regular' 레이아웃으로 구현하여 사용 가능한 공간에 따라 전환하겠습니다. iPhone 레이아웃은 창이 좁을 때 iPad에도 나타납니다. 이렇게 하면 Stage Manager와 iOS 26에 대비할 수 있습니다."
"그냥 GeometryReader를 쓰세요, 괜찮아요"
유혹: 모든 것을 GeometryReader로 감싸기.
응답: "GeometryReader는 알려진 레이아웃 부작용이 있습니다. 탐욕적으로 확장됩니다. onGeometryChange는 레이아웃에 영향을 주지 않고 동일한 데이터를 읽습니다. iOS 16으로 이식되어 있습니다."
"크기 클래스가 이전에는 잘 작동했어요"
유혹: 모든 것을 크기 클래스를 통해 강제하기.
응답: "크기 클래스는 조악합니다. iPad는 두 방향 모두 .regular입니다. 넓은 범주에는 크기 클래스를, 정밀한 임계값에는 기하학 정보를 사용하겠습니다."
"iPad 멀티태스킹을 지원하지 않아요"
유혹: UIRequiresFullScreen = true
응답: "Apple은 iOS 26에서 전체 화면 전용을 사용 중단했습니다. 활성 Split View 지원이 없더라도 앱은 크기가 조정될 때 깨질 수 없습니다. 공간 기반 레이아웃은 동일한 비용이 듭니다."
리소스
WWDC: 2025-208, 2024-10074, 2022-10056
스킬: axiom-swiftui-layout-ref, axiom-swiftui-debugging, axiom-liquid-glass