SwiftUI UI Patterns
Schnellstart
Wähle einen Pfad basierend auf deinem Ziel:
Bestehendes Projekt
- Identifiziere die Funktion oder den Bildschirm und das primäre Interaktionsmodell (Liste, Detail, Editor, Einstellungen, Tabs).
- Finde ein nahegelegenes Beispiel im Repository mit
rg "TabView\("oder ähnlich, lies dann die nächste SwiftUI-View. - Wende lokale Konventionen an: Bevorzuge SwiftUI-native Zustände, halte Zustände nach Möglichkeit lokal und verwende Environment-Injection für gemeinsame Abhängigkeiten.
- Wähle die relevante Komponentenreferenz aus
references/components-index.mdund folge deren Anleitung. - Erstelle die View aus kleinen, fokussierten Subviews und SwiftUI-nativem Datenfluss.
Neues Projekt-Scaffolding
- Beginne mit
references/app-scaffolding-wiring.md, um TabView + NavigationStack + Sheets zu verdrahten. - Füge einen minimalen
AppTabundRouterPathbasierend auf den bereitgestellten Gerüsten hinzu. - Wähle die nächste Komponentenreferenz basierend auf der zuerst benötigten UI (TabView, NavigationStack, Sheets).
- Erweitere die Route- und Sheet-Enums, wenn neue Bildschirme hinzugefügt werden.
Allgemeine Regeln
- Verwende moderne SwiftUI-Zustände (
@State,@Binding,@Observable,@Environment) und vermeide unnötige ViewModels. - Bevorzuge Komposition; halte Views klein und fokussiert.
- Verwende async/await mit
.taskund expliziten Lade-/Fehlerzuständen. - Behalte bestehende Legacy-Muster nur bei, wenn du Legacy-Dateien bearbeitest.
- Folge dem Formatierer und Styleguide des Projekts.
- Sheets: Bevorzuge
.sheet(item:)gegenüber.sheet(isPresented:), wenn der Zustand ein ausgewähltes Modell repräsentiert. Vermeideif letinnerhalb des Sheet-Bodys. Sheets sollten ihre eigenen Aktionen besitzen unddismiss()intern aufrufen, anstattonCancel/onConfirm-Closures weiterzuleiten.
Workflow für eine neue SwiftUI-View
- Definiere den Zustand der View und dessen Besitzer.
- Identifiziere Abhängigkeiten, die über
@Environmentinjiziert werden. - Skizziere die View-Hierarchie und extrahiere wiederholte Teile in Subviews.
- Implementiere asynchrones Laden mit
.taskund gegebenenfalls einem expliziten Zustands-Enum. - Füge Accessibility-Labels oder -Identifikatoren hinzu, wenn die UI interaktiv ist.
- Validiere mit einem Build und aktualisiere ggf. die Aufrufstellen.
Komponentenreferenzen
Verwende references/components-index.md als Einstiegspunkt. Jede Komponentenreferenz sollte Folgendes enthalten:
- Absicht und beste Anwendungsszenarien.
- Minimales Nutzungsmuster mit lokalen Konventionen.
- Fallstricke und Hinweise zur Performance.
- Pfade zu vorhandenen Beispielen im aktuellen Repository.
Sheet-Muster
Item-gesteuertes Sheet (bevorzugt)
@State private var selectedItem: Item?
.sheet(item: $selectedItem) { item in
EditItemSheet(item: item)
}
Sheet besitzt seine Aktionen
struct EditItemSheet: View {
@Environment(\.dismiss) private var dismiss
@Environment(Store.self) private var store
let item: Item
@State private var isSaving = false
var body: some View {
VStack {
Button(isSaving ? "Speichern…" : "Speichern") {
Task { await save() }
}
}
}
private func save() async {
isSaving = true
await store.save(item)
dismiss()
}
}
Hinzufügen einer neuen Komponentenreferenz
- Erstelle
references/<component>.md. - Halte es kurz und handlungsorientiert; verlinke auf konkrete Dateien im aktuellen Repository.
- Aktualisiere
references/components-index.mdmit dem neuen Eintrag.