Modèles d'UI SwiftUI
Démarrage rapide
Choisissez un parcours en fonction de votre objectif :
Projet existant
- Identifiez la fonctionnalité ou l'écran ainsi que le modèle d'interaction principal (liste, détail, éditeur, paramètres, à onglets).
- Trouvez un exemple proche dans le dépôt avec
rg "TabView\("ou similaire, puis lisez la vue SwiftUI la plus pertinente. - Appliquez les conventions locales : privilégiez l'état natif SwiftUI, gardez l'état local lorsque c'est possible, et utilisez l'injection d'environnement pour les dépendances partagées.
- Choisissez la référence de composant appropriée dans
references/components-index.mdet suivez ses directives. - Construisez la vue avec de petites sous-vues ciblées et un flux de données natif SwiftUI.
Nouveau projet (scaffolding)
- Commencez par
references/app-scaffolding-wiring.mdpour câbler TabView + NavigationStack + les feuilles. - Ajoutez un
AppTabet unRouterPathminimaux basés sur les squelettes fournis. - Choisissez la référence de composant suivante en fonction de l'UI dont vous avez besoin en premier (TabView, NavigationStack, Sheets).
- Étendez les énumérations de routes et de feuilles au fur et à mesure que de nouveaux écrans sont ajoutés.
Règles générales à suivre
- Utilisez l'état moderne de SwiftUI (
@State,@Binding,@Observable,@Environment) et évitez les View Models inutiles. - Privilégiez la composition ; gardez les vues petites et ciblées.
- Utilisez
async/awaitavec.tasket des états explicites de chargement et d'erreur. - Conservez les motifs existants seulement lors de la modification de fichiers existants.
- Suivez le formatteur et le guide de style du projet.
- Feuilles modales : préférez
.sheet(item:)à.sheet(isPresented:)lorsque l'état représente un modèle sélectionné. Évitezif letà l'intérieur du corps d'une feuille. Les feuilles doivent gérer leurs actions et appelerdismiss()en interne plutôt que de transmettre des closuresonCancel/onConfirm.
Workflow pour une nouvelle vue SwiftUI
- Définissez l'état de la vue et son emplacement de propriété.
- Identifiez les dépendances à injecter via
@Environment. - Esquissez la hiérarchie des vues et extrayez les parties répétées dans des sous-vues.
- Implémentez le chargement asynchrone avec
.tasket une énumération d'état explicite si nécessaire. - Ajoutez des étiquettes ou identifiants d'accessibilité lorsque l'UI est interactive.
- Validez avec une compilation et mettez à jour les sites d'appel si nécessaire.
Références de composants
Utilisez references/components-index.md comme point d'entrée. Chaque référence de composant doit inclure :
- L'intention et les scénarios les mieux adaptés.
- Un modèle d'utilisation minimal avec les conventions locales.
- Les pièges et les notes de performance.
- Les chemins vers les exemples existants dans le dépôt actuel.
Modèles de feuilles modales
Feuille pilotée par un élément (préféré)
@State private var selectedItem: Item?
.sheet(item: $selectedItem) { item in
EditItemSheet(item: item)
}
La feuille gère ses propres actions
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 ? "Sauvegarde…" : "Sauvegarder") {
Task { await save() }
}
}
}
private func save() async {
isSaving = true
await store.save(item)
dismiss()
}
}
Ajouter une nouvelle référence de composant
- Créez
references/<composant>.md. - Restez court et actionnable ; liez des fichiers concrets dans le dépôt actuel.
- Mettez à jour
references/components-index.mdavec la nouvelle entrée.