Refactorisation de vues SwiftUI
Attribution : copié depuis Dimillian/Skills de @Dimillian (2025-12-31).
Présentation
Appliquer une structure et un modèle de dépendance cohérents aux vues SwiftUI, en mettant l'accent sur l'ordre, les patterns Model-View (MV), la gestion minutieuse des modèles de vue et l'utilisation correcte d'Observation.
Directives principales
1) Ordre des vues (du haut vers le bas)
Environmentprivate/publiclet@State/ autres propriétés stockéesvarcalculées (hors vue)initbody- Constructeurs de vues calculés / autres aides de vue
- Fonctions d'aide / asynchrones
2) Privilégier les patterns MV (Model-View)
- Par défaut, utiliser MV : les vues sont des expressions d'état légères ; les modèles/services possèdent la logique métier.
- Favoriser
@State,@Environment,@Queryettask/onChangepour l'orchestration. - Injecter les services et modèles partagés via
@Environment; garder les vues petites et composables. - Diviser les grandes vues en sous-vues plutôt que d'introduire un modèle de vue.
3) Diviser les grands corps et les propriétés de vue
- Si
bodydépasse un écran ou comporte plusieurs sections logiques, le diviser en sous-vues plus petites. - Extraire les grandes propriétés de vue calculées (
var header: some View { ... }) dans des typesViewdédiés lorsqu'elles portent un état ou une ramification complexe. - Il est acceptable de conserver les sous-vues connexes en tant que propriétés de vue calculées dans le même fichier ; n'extraire dans une structure
Viewautonome que lorsque cela a un sens structurel ou que la réutilisation est souhaitée. - Préférer passer de petites entrées (données, liaisons, rappels) plutôt que de réutiliser l'état complet de la vue parente.
Exemple (extraction d'une section) :
var body: some View {
VStack(alignment: .leading, spacing: 16) {
HeaderSection(title: title, isPinned: isPinned)
DetailsSection(details: details)
ActionsSection(onSave: onSave, onCancel: onCancel)
}
}
Exemple (long body → body plus court + vues calculées dans le même fichier) :
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 }
}
}
}
}
Exemple (extraction d'une vue calculée complexe) :
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) Gestion des modèles de vue (uniquement s'ils existent déjà)
- Ne pas introduire de modèle de vue sauf si la demande ou le code existant le nécessite clairement.
- Si un modèle de vue existe, le rendre non-optionnel lorsque c'est possible.
- Passer les dépendances à la vue via
init, puis les passer au modèle de vue dans l'initde la vue. - Éviter les patterns
bootstrapIfNeeded.
Exemple (basé sur Observation) :
@State private var viewModel: SomeViewModel
init(dependency: Dependency) {
_viewModel = State(initialValue: SomeViewModel(dependency: dependency))
}
5) Utilisation d'Observation
- Pour les types de référence
@Observable, les stocker avec@Statedans la vue racine. - Transmettre explicitement les observables vers le bas si nécessaire ; éviter les états optionnels sauf si requis.
Flux de travail
- Réorganiser la vue pour correspondre aux règles d'ordre.
- Favoriser MV : déplacer l'orchestration légère dans la vue en utilisant
@State,@Environment,@Query,tasketonChange. - Si un modèle de vue existe, remplacer les modèles de vue optionnels par un modèle de vue
@Statenon optionnel initialisé dansiniten passant les dépendances depuis la vue. - Confirmer l'utilisation d'Observation :
@Statepour les modèles de vue@Observableracines, pas d'encapsulateurs redondants. - Maintenir le comportement intact : ne pas modifier la mise en page ou la logique métier sauf demande explicite.
Remarques
- Préférer des aides petites et explicites plutôt que de grands blocs conditionnels.
- Placer les constructeurs de vues calculés après
bodyet lesvarcalculées non liées à la vue avantinit. - Pour des conseils et la justification du MV-first, voir
references/mv-patterns.md.