Refactorisation de vue SwiftUI
Aperçu
Applique une structure et un modèle de dépendance cohérents aux vues SwiftUI, en mettant l'accent sur l'ordre, les motifs Model-View (MV), la gestion prudente des view models et l'utilisation correcte d'Observation.
Directives principales
1) Ordre de la vue (haut → bas)
- Environment
private/publiclet@State/ autres propriétés stockéesvarcalculées (non-vue)initbody- Constructeurs de vue calculés / autres helpers de vue
- Fonctions helper / asynchrones
2) Privilégier les motifs 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,@Query, ettask/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 view model.
3) Diviser les grands corps et propriétés de vue
- Si
bodydépasse la taille d'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 { ... }) en typesViewdédiés lorsqu'elles portent un état ou des branchements complexes. - Il est acceptable de conserver des sous-vues connexes comme propriétés de vue calculées dans le même fichier ; n'extraire en une structure
Viewautonome que lorsque cela a un sens structurel ou que la réutilisation est prévue. - Privilégier le passage de petites entrées (données, liaisons, callbacks) plutôt que la réutilisation de l'état complet de la vue parent.
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 du view model (uniquement s'il est déjà présent)
- N'introduisez un view model que si la demande ou le code existant en réclame clairement un.
- Si un view model existe, rendez-le non-optionnel lorsque c'est possible.
- Passez les dépendances à la vue via
init, puis transmettez-les au view model dans l'initde la vue. - Évitez les motifs
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, stockez-les en tant que@Statedans la vue racine. - Passez les observables explicitement vers le bas selon les besoins ; évitez les états optionnels sauf si nécessaire.
Workflow
- Réordonnez la vue pour respecter les règles d'ordre.
- Favorisez MV : déplacez l'orchestration légère dans la vue en utilisant
@State,@Environment,@Query,tasketonChange. - Si un view model existe, remplacez les view models optionnels par un view model
@Statenon-optionnel initialisé dansiniten passant les dépendances de la vue. - Confirmez l'utilisation d'Observation :
@Statepour les view models racine@Observable, pas de wrappers redondants. - Maintenez le comportement intact : ne modifiez pas la mise en page ou la logique métier sauf si cela est demandé.
Notes
- Privilégiez les helpers petits et explicites plutôt que de grands blocs conditionnels.
- Gardez les constructeurs de vue calculés en dessous de
bodyet les vars calculées non-vue au-dessus d'init. - Pour des conseils et la justification du MV, voir
references/mv-patterns.md.
Gestion des grandes vues
- Lorsqu'un fichier de vue SwiftUI dépasse environ 300 lignes, divisez-le à l'aide d'extensions pour regrouper les helpers connexes. Déplacez les fonctions asynchrones et les fonctions helper dans des extensions
privatedédiées, séparées par des commentaires// MARK: -qui décrivent leur objectif (par exemple,// MARK: - Actions,// MARK: - Subviews,// MARK: - Helpers). Gardez la structurestructprincipale concentrée sur les propriétés stockées, l'init et lebody, avec les vars calculées de construction de vue également regroupées via des marques lorsque le fichier est long.