SwiftUI View Refactor
Zuschreibung: Kopiert von @Dimillians Dimillian/Skills (2025-12-31).
Übersicht
Wende eine konsistente Struktur und ein einheitliches Abhängigkeitsmuster auf SwiftUI-Views an, mit Fokus auf Anordnung, Model-View (MV)-Muster, sorgfältige ViewModel-Behandlung und korrekte Observation-Nutzung.
Kernrichtlinien
1) View-Anordnung (oben → unten)
- Environment
private/publiclet@State/ andere gespeicherte Eigenschaften- berechnete
var(nicht View) initbody- berechnete View-Builder / andere View-Helfer
- Helfer / asynchrone Funktionen
2) Bevorzuge MV (Model-View)-Muster
- Standardmäßig MV: Views sind leichtgewichtige Zustandsausdrücke; Modelle/Services besitzen die Geschäftslogik.
- Bevorzuge
@State,@Environment,@Queryundtask/onChangefür die Orchestrierung. - Injiziere Services und gemeinsame Modelle über
@Environment; halte Views klein und komponierbar. - Teile große Views in Unterviews auf, anstatt ein ViewModel einzuführen.
3) Große Bodies und View-Eigenschaften aufteilen
- Wenn
bodygrößer als ein Bildschirm wird oder mehrere logische Abschnitte hat, teile ihn in kleinere Unterviews auf. - Extrahiere große berechnete View-Eigenschaften (
var header: some View { ... }) in dedizierteView-Typen, wenn sie Zustand oder komplexe Verzweigungen enthalten. - Es ist in Ordnung, verwandte Unterviews als berechnete View-Eigenschaften in derselben Datei zu behalten; extrahiere sie nur dann in eine eigenständige
View-Struktur, wenn es strukturell sinnvoll ist oder eine Wiederverwendung beabsichtigt ist. - Bevorzuge die Übergabe kleiner Eingaben (Daten, Bindungen, Callbacks) anstelle der Wiederverwendung des gesamten übergeordneten View-Status.
Beispiel (Extrahieren eines Abschnitts):
var body: some View {
VStack(alignment: .leading, spacing: 16) {
HeaderSection(title: title, isPinned: isPinned)
DetailsSection(details: details)
ActionsSection(onSave: onSave, onCancel: onCancel)
}
}
Beispiel (langer Body → kürzerer Body + berechnete Views in derselben Datei):
var body: some View {
List {
header
filters
results
footer
}
}
private var header: some View {
VStack(alignment: .leading, spacing: 6) {
Text(title).font(.title2)
Text(subtitle).font(.subheadline)
}
}
private var filters: some View {
ScrollView(.horizontal, showsIndicators: false) {
HStack {
ForEach(filterOptions, id: \.self) { option in
FilterChip(option: option, isSelected: option == selectedFilter)
.onTapGesture { selectedFilter = option }
}
}
}
}
Beispiel (Extrahieren einer komplexen berechneten View):
private var header: some View {
HeaderSection(title: title, subtitle: subtitle, status: status)
}
private struct HeaderSection: View {
let title: String
let subtitle: String?
let status: Status
var body: some View {
VStack(alignment: .leading, spacing: 4) {
Text(title).font(.headline)
if let subtitle { Text(subtitle).font(.subheadline) }
StatusBadge(status: status)
}
}
}
4) ViewModel-Behandlung (nur wenn bereits vorhanden)
- Führe kein ViewModel ein, es sei denn, die Anfrage oder der vorhandene Code erfordert es eindeutig.
- Wenn ein ViewModel existiert, mache es möglichst nicht optional.
- Übergib Abhängigkeiten an die View über
initund reiche sie dann iminitder View an das ViewModel weiter. - Vermeide
bootstrapIfNeeded-Muster.
Beispiel (Observationsbasiert):
@State private var viewModel: SomeViewModel
init(dependency: Dependency) {
_viewModel = State(initialValue: SomeViewModel(dependency: dependency))
}
5) Observation-Nutzung
- Für
@Observable-Referenztypen speichere sie als@Statein der root-View. - Gib Observables bei Bedarf explizit nach unten weiter; vermeide optionalen Zustand, außer wenn erforderlich.
Arbeitsablauf
- Ordne die View neu an, um den Anordnungsregeln zu entsprechen.
- Bevorzuge MV: Verlagere leichte Orchestrierung in die View mit
@State,@Environment,@Query,taskundonChange. - Wenn ein ViewModel existiert, ersetze optionale ViewModels durch ein nicht optionales
@StateViewModel, das iminitdurch Übergabe von Abhängigkeiten aus der View initialisiert wird. - Bestätige die Observation-Nutzung:
@Statefür root@ObservableViewModels, keine redundanten Wrapper. - Behalte das Verhalten bei: Ändere kein Layout oder Geschäftslogik, außer es wird angefordert.
Hinweise
- Bevorzuge kleine, explizite Helfer gegenüber großen bedingten Blöcken.
- Halte berechnete View-Builder unter
bodyund nicht-View berechnete Variablen überinit. - Für MV-erste Anleitung und Begründung siehe
references/mv-patterns.md.