Modèles d'interface SwiftUI
Démarrage rapide
Choisissez un parcours selon votre objectif :
Projet existant
- Identifiez la fonctionnalité ou l'écran et le principal modèle d'interaction (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 proche. - Appliquez les conventions locales : privilégiez l'état natif SwiftUI, conservez l'état local quand c'est possible, et utilisez l'injection d'environnement pour les dépendances partagées.
- Choisissez la référence de composant pertinente dans
references/components-index.mdet suivez ses instructions. - Construisez la vue avec des sous-vues petites et ciblées et un flux de données natif SwiftUI.
Nouveau squelette de projet
- Commencez par
references/app-scaffolding-wiring.mdpour câbler TabView + NavigationStack + sheets. - Ajoutez un
AppTabet unRouterPathminimaux basés sur les squelettes fournis. - Choisissez la prochaine référence de composant en fonction de l'interface 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 SwiftUI moderne (
@State,@Binding,@Observable,@Environment) et évitez les modèles de vue inutiles. - Préférez la composition ; gardez les vues petites et ciblées.
- Utilisez async/await avec
.tasket des états de chargement/erreur explicites. - Maintenez les modèles hérités existants uniquement lors de la modification de fichiers hérités.
- Suivez le formateur et le guide de style du projet.
- Feuilles : Préférez
.sheet(item:)à.sheet(isPresented:)lorsque l'état représente un modèle sélectionné. Évitezif letdans le corps d'une feuille. Les feuilles doivent posséder leurs actions et appelerdismiss()en interne au lieu de transmettre des fermeturesonCancel/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 de la vue et extrayez les parties répétées dans des sous-vues.
- Implémentez le chargement asynchrone avec
.tasket un énumérateur d'état explicite si nécessaire. - Ajoutez des étiquettes ou identifiants d'accessibilité lorsque l'interface est interactive.
- Validez avec une compilation et mettez à jour les sites d'appels 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
Feuille pilotée par élément (préférée)
@State private var selectedItem: Item?
.sheet(item: $selectedItem) { item in
EditItemSheet(item: item)
}
La feuille possède ses 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()
}
}
Ajout d'une nouvelle référence de composant
- Créez
references/<composant>.md. - Gardez-le court et actionnable ; liez des fichiers concrets dans le dépôt actuel.
- Mettez à jour
references/components-index.mdavec la nouvelle entrée.