SwiftUI UI Patterns
Schnellstart
Wählen Sie einen Pfad basierend auf Ihrem Ziel:
Bestehendes Projekt
- Identifizieren Sie die Funktion oder den Bildschirm und das primäre Interaktionsmodell (Liste, Detail, Editor, Einstellungen, Tabbed).
- Finden Sie ein nahegelegenes Beispiel im Repository mit
rg "TabView\("oder ähnlich, und lesen Sie dann die nächstgelegene SwiftUI-View. - Wenden Sie lokale Konventionen an: bevorzugen Sie SwiftUI-nativen State, halten Sie State möglichst lokal und verwenden Sie Environment Injection für gemeinsame Abhängigkeiten.
- Wählen Sie die relevante Komponentenreferenz aus
references/components-index.mdund folgen Sie deren Anleitung. - Erstellen Sie die View mit kleinen, fokussierten Subviews und SwiftUI-nativem Datenfluss.
Neues Projekt-Scaffolding
- Beginnen Sie mit
references/app-scaffolding-wiring.md, um TabView + NavigationStack + Sheets zu verdrahten. - Fügen Sie ein minimales
AppTabundRouterPathbasierend auf den bereitgestellten Skeletten hinzu. - Wählen Sie die nächste Komponentenreferenz basierend auf der UI, die Sie zuerst benötigen (TabView, NavigationStack, Sheets).
- Erweitern Sie die Route- und Sheet-Enums, wenn neue Bildschirme hinzugefügt werden.
Allgemeine Regeln
- Verwenden Sie modernen SwiftUI-State (
@State,@Binding,@Observable,@Environment) und vermeiden Sie unnötige View-Modelle. - Bevorzugen Sie Komposition; halten Sie Views klein und fokussiert.
- Verwenden Sie async/await mit
.taskund expliziten Lade-/Fehlerzuständen. - Behalten Sie bestehende Legacy-Patterns nur bei, wenn Sie Legacy-Dateien bearbeiten.
- Befolgen Sie den Formatierungs- und Style-Guide des Projekts.
- Sheets: Bevorzugen Sie
.sheet(item:)gegenüber.sheet(isPresented:), wenn der State ein ausgewähltes Modell repräsentiert. Vermeiden Sieif letim Sheet-Body. Sheets sollten ihre Aktionen selbst verwalten unddismiss()intern aufrufen, anstattonCancel/onConfirm-Closures zu übergeben.
Workflow für eine neue SwiftUI-View
- Definieren Sie den State der View und dessen Eigentumsort.
- Identifizieren Sie Abhängigkeiten, die über
@Environmentinjiziert werden. - Skizzieren Sie die View-Hierarchie und extrahieren Sie wiederholte Teile in Subviews.
- Implementieren Sie asynchrones Laden mit
.taskund ggf. einem expliziten State-Enum. - Fügen Sie Accessibility-Labels oder -Identifier hinzu, wenn die UI interaktiv ist.
- Validieren Sie mit einem Build und aktualisieren Sie ggf. die Aufrufstellen.
Komponentenreferenzen
Verwenden Sie references/components-index.md als Einstiegspunkt. Jede Komponentenreferenz sollte Folgendes enthalten:
- Verwendungszweck und optimale Einsatzszenarien.
- Minimales Nutzungsmuster mit lokalen Konventionen.
- Fallstricke und Leistungshinweise.
- Pfade zu vorhandenen Beispielen im aktuellen Repository.
Sheet-Patterns
Item-gesteuertes Sheet (bevorzugt)
@State private var selectedItem: Item?
.sheet(item: $selectedItem) { item in
EditItemSheet(item: item)
}
Sheet verwaltet seine Aktionen selbst
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
- Erstellen Sie
references/<component>.md. - Halten Sie sie kurz und handlungsorientiert; verlinken Sie auf konkrete Dateien im aktuellen Repository.
- Aktualisieren Sie
references/components-index.mdmit dem neuen Eintrag.