SwiftUI Adaptives Layout
Übersicht
Disziplinierendes Skill zum Erstellen von Layouts, die auf verfügbaren Platz reagieren, anstatt auf Geräteannahmen. Behandelt Werkzeugauswahl, Einschränkungen von Size Classes, iOS 26-freie Fenster und häufige Anti-Patterns.
Kernprinzip: Ihr Layout sollte korrekt funktionieren, wenn Apple morgen ein neues Gerät ausliefert oder iPadOS nächstes Jahr einen neuen Multitasking-Modus hinzufügt. Reagieren Sie auf Ihren Container, nicht auf Ihre Annahmen über das Gerät.
Wann Sie dieses Skill verwenden sollten
- „Wie bringe ich dieses Layout auf iPad und iPhone zum Laufen?“
- „Soll ich GeometryReader oder ViewThatFits verwenden?“
- „Mein Layout geht in Split View / Stage Manager kaputt“
- „Size Classes liefern nicht, was ich brauche“
- „Designer wünscht unterschiedliches Layout für Hoch- vs. Querformat“
- „App für iOS 26-Fensteranpassung vorbereiten“
Entscheidungsbaum
„Ich brauche mein Layout, um sich anzupassen…“
│
├─ AN VERFÜGBAREN PLATZ (containergesteuert)
│ │
│ ├─ „Bestpassende Variante auswählen“
│ │ → ViewThatFits
│ │
│ ├─ „Animierter Wechsel zwischen H↔V“
│ │ → AnyLayout + Bedingung
│ │
│ ├─ „Größe für Berechnungen auslesen“
│ │ → onGeometryChange (iOS 16+)
│ │
│ └─ „Benutzerdefinierter Layout-Algorithmus“
│ → Layout-Protokoll
│
├─ AN PLATTFORM-MERKMALE
│ │
│ ├─ „Kompakte vs. reguläre Breite“
│ │ → horizontalSizeClass (⚠️ iPad-Einschränkungen)
│ │
│ ├─ „Barrierefreiheit Textgröße“
│ │ → dynamicTypeSize.isAccessibilitySize
│ │
│ └─ „Plattformunterschiede“
│ → #if os() / Environment
│
└─ AN FENSTERFORM (Seitenverhältnis)
│
├─ „Hoch- vs. Querformatsemantik“
│ → Geometry + benutzerdefinierter Schwellenwert
│
├─ „Spalten automatisch ein-/ausblenden“
│ → NavigationSplitView (automatisch in iOS 26)
│
└─ „Fensterlebenszyklus“
→ @Environment(\.scenePhase)
Werkzeugauswahl
Schnellentscheidung
Benötigen Sie einen berechneten Wert (Breite, Höhe)?
├─ JA → onGeometryChange
└─ NEIN → Benötigen Sie animierte Übergänge?
├─ JA → AnyLayout + Bedingung
└─ NEIN → ViewThatFits
Wann welches Werkzeug verwenden
| Ich muss… | Verwende dies | Nicht dies |
|---|---|---|
| Zwischen 2-3 Layout-Varianten wählen | ViewThatFits | if Größe > X |
| H↔V mit Animation wechseln | AnyLayout | Bedingtes HStack/VStack |
| Containergröße auslesen | onGeometryChange | GeometryReader |
| An Barrierefreiheit-Text anpassen | dynamicTypeSize | Feste Haltepunkte |
| Kompakte Breite erkennen | horizontalSizeClass | UIDevice.idiom |
| Schmales Fenster auf iPad erkennen | Geometry + Schwellenwert | Size Class allein |
| Seitenleiste ein-/ausblenden | NavigationSplitView | Manuelle Spaltenlogik |
| Benutzerdefinierter Layout-Algorithmus | Layout-Protokoll | Verschachtelte GeometryReader |
Muster 1: ViewThatFits
Verwenden, wenn: Sie 2-3 Layout-Varianten haben und möchten, dass SwiftUI die erste auswählt, die passt.
ViewThatFits {
// Erste Wahl: horizontal
HStack {
Image(systemName: "star")
Text("Favorite")
Spacer()
Button("Add") { }
}
// Fallback: vertikal
VStack {
HStack {
Image(systemName: "star")
Text("Favorite")
}
Button("Add") { }
}
}
Einschränkung: ViewThatFits gibt nicht preis, welche Variante ausgewählt wurde. Wenn Sie diesen Zustand für andere Ansichten benötigen, verwenden Sie stattdessen AnyLayout.
Muster 2: AnyLayout für animierten Wechsel
Verwenden, wenn: Sie animierte Übergänge zwischen Layouts benötigen oder den aktuellen Layout-Zustand kennen müssen.
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)
}
}
Für Dynamic Type:
@Environment(\.dynamicTypeSize) var dynamicTypeSize
var layout: AnyLayout {
dynamicTypeSize.isAccessibilitySize
? AnyLayout(VStackLayout())
: AnyLayout(HStackLayout())
}
Muster 3: onGeometryChange (bevorzugt für Geometrie)
Verwenden, wenn: Sie tatsächliche Abmessungen für Berechnungen benötigen. Bevorzugt gegenüber 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
}
}
}
Zur Erkennung des Seitenverhältnisses (iPad „Ausrichtung“):
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
}
}
}
Muster 4: GeometryReader (wenn nötig)
Verwenden, wenn: Sie Geometrie benötigen UND iOS 15 oder älter verwenden, ODER Geometrie während der Layout-Phase benötigen (nicht nur als Nebeneffekt).
// ✅ RICHTIG: Eingeschränkter GeometryReader
VStack {
GeometryReader { geo in
Text("Breite: \(geo.size.width)")
}
.frame(height: 44) // MUSS eingeschränkt werden!
Button("Next") { }
}
// ❌ FALSCH: Uneingeschränkt (gierig)
VStack {
GeometryReader { geo in
Text("Breite: \(geo.size.width)")
}
// Nimmt gesamten verfügbaren Platz, zerdrückt Geschwister
Button("Next") { }
}
Wahrheitstabelle der Size Classes (iPad)
| Konfiguration | Horizontal | Vertikal |
|---|---|---|
| Vollbild Hochformat | .regular | .regular |
| Vollbild Querformat | .regular | .regular |
| 70 % Split View | .regular | .regular |
| 50 % Split View | .regular | .regular |
| 33 % Split View | .compact | .regular |
| Slide Over | .compact | .regular |
| Mit Tastatur | (unverändert) | (unverändert) |
Wichtige Erkenntnis: Die Size Class wird auf dem iPad nur bei ~33 % Breite oder Slide Over zu .compact. Für feinere Steuerung Geometrie verwenden.
iOS 26 Freie Fenster
Was sich geändert hat
| Vor iOS 26 | iOS 26+ |
|---|---|
| Feste Split View-Größen | Freies Ziehen zum Ändern der Größe |
UIRequiresFullScreen erlaubt | Veraltet |
| Keine Menüleiste auf iPad | Menüleiste über .commands |
| Manuelle Spaltensichtbarkeit | NavigationSplitView passt sich automatisch an |
Apples Richtlinie
„Das Ändern der Größe einer App sollte das Layout nicht dauerhaft verändern. Seien Sie opportunistisch, wann immer möglich zum Ausgangszustand zurückzukehren.“
Übersetzung: Speichern Sie den Layout-Zustand nicht basierend auf der Fenstergröße. Wenn das Fenster zur ursprünglichen Größe zurückkehrt, sollte auch das Layout zurückkehren.
NavigationSplitView Automatische Anpassung
// iOS 26: Spalten werden automatisch ein-/ausgeblendet
NavigationSplitView {
Sidebar()
} content: {
ContentList()
} detail: {
DetailView()
}
// Keine manuelle columnVisibility-Verwaltung erforderlich
Migrations-Checkliste
- Entfernen Sie
UIRequiresFullScreenaus Info.plist - Testen Sie bei beliebigen Fenstergrößen (nicht nur 33/50/66 %)
- Stellen Sie sicher, dass das Layout nach der Größenänderung nicht „kleben bleibt“
- Fügen Sie Menüleistenbefehle für häufige Aktionen hinzu
- Testen Sie, dass Fenstersteuerelemente nicht mit Toolbar-Elementen überlappen
Anti-Patterns
❌ Geräteausrichtungsbeobachter
// ❌ FALSCH: Meldet Gerät, nicht Fenster
NotificationCenter.default.addObserver(
forName: UIDevice.orientationDidChangeNotification, ...
)
let orientation = UIDevice.current.orientation
if orientation.isLandscape { ... }
Warum es fehlschlägt: Meldet die physische Geräteausrichtung, nicht die Fensterform. Falsch in Split View, Stage Manager, iOS 26.
Lösung: Verwenden Sie onGeometryChange, um die tatsächlichen Fensterabmessungen auszulesen.
❌ Bildschirmgrenzen
// ❌ FALSCH: Gibt den gesamten Bildschirm zurück, nicht Ihr Fenster
let width = UIScreen.main.bounds.width
if width > 700 { useWideLayout() }
Warum es fehlschlägt: Bei Multitasking kann Ihre App nur 40 % des Bildschirms haben.
Lösung: Lesen Sie die tatsächliche Containergröße Ihrer Ansicht aus.
❌ Gerätemodellprüfungen
// ❌ FALSCH: Bricht bei neuen Geräten, falsch bei Multitasking
if UIDevice.current.userInterfaceIdiom == .pad {
useWideLayout()
}
Warum es fehlschlägt: iPad in 1/3 Split View ist schmaler als iPhone 14 Pro Max im Querformat.
Lösung: Reagieren Sie auf verfügbaren Platz, nicht auf die Geräteidentität.
❌ Uneingeschränkter GeometryReader
// ❌ FALSCH: GeometryReader ist gierig
VStack {
GeometryReader { geo in
Text("Größe: \(geo.size)")
}
Button("Next") { } // Zerquetscht
}
Lösung: Mit .frame() einschränken oder onGeometryChange verwenden.
❌ Size Class als Ausrichtungsersatz
// ❌ FALSCH: iPad ist in beiden Ausrichtungen .regular
var isLandscape: Bool {
horizontalSizeClass == .regular // Auf iPad immer wahr!
}
Lösung: Berechnen Sie aus der tatsächlichen Geometrie, wenn Sie das Seitenverhältnis benötigen.
Druckszenarien
„Designer wünscht iPhone-spezifisches Layout“
Versuchung: if UIDevice.current.userInterfaceIdiom == .phone
Antwort: „Ich werde diese als 'kompakte' und 'reguläre' Layouts implementieren, die basierend auf dem verfügbaren Platz wechseln. Das iPhone-Layout erscheint auf dem iPad, wenn das Fenster schmal ist. Das macht uns zukunftssicher für Stage Manager und iOS 26.“
„Verwende einfach GeometryReader, es ist in Ordnung“
Versuchung: Alles in GeometryReader einwickeln.
Antwort: „GeometryReader hat bekannte Layout-Nebeneffekte – es dehnt sich gierig aus. onGeometryChange liest dieselben Daten, ohne das Layout zu beeinflussen. Es ist ab iOS 16 verfügbar.“
„Size Classes haben vorher funktioniert“
Versuchung: Alles durch Size Class erzwingen.
Antwort: „Size Classes sind grob. iPad ist in beiden Ausrichtungen .regular. Ich werde Size Class für breite Kategorien und Geometrie für präzise Schwellenwerte verwenden.“
„Wir unterstützen kein iPad-Multitasking“
Versuchung: UIRequiresFullScreen = true
Antwort: „Apple hat den Nur-Vollbild-Modus in iOS 26 als veraltet erklärt. Selbst ohne aktive Split View-Unterstützung darf die App beim Ändern der Größe nicht kaputtgehen. Platzbasiertes Layout kostet gleich viel.“
Ressourcen
WWDC: 2025-208, 2024-10074, 2022-10056
Skills: axiom-swiftui-layout-ref, axiom-swiftui-debugging, axiom-liquid-glass