Les variables qui définissent l'état de la vue (View State)¶
Le rafraîchissement d'une vue SwiftUI est associé à ses variables d'état. Dès qu'une variable d'état change, SwiftUI redessine ce qui est nécessaire.
La programmation avec React utilise un principe semblable. Et sous React, les variables responsables du rafraîchissement d'un composant s'appellent également variables d'état.
On peut comparer les variables d'état à un tableau de bord. Il s'agit des informations qui nous indiquent comment est notre vue à un moment donné.
Déclarer une variable d'état¶
Dans SwiftUI, on déclare les variables d'état dans la vue à l'aide du modificateur de propriété (property wrapper) @State :
struct ContentView: View {
@State private var maVariableDEtat: Bool = false
@State private var autreVariableDEtat: String = ""
var body: some View {
...
}
}
Les variables d'état devraient toujours être privées (private).
Il faut toujours leur donner une valeur de départ.
Notez que si le code de la vue doit modifier la valeur d'une variable déclarée dans sa structure et que cette variable n'a pas été déclarée avec @State, vous obtiendrez le message « Cannot assign to property: 'self' is immutable ».

Comme le message l'indique, une structure est immuable par défaut. Puisque ContentView est une structure, ses propriétés ne peuvent pas être modifiées directement.
La solution consiste à ajouter @State devant cette variable.
Modifier une variable d'état¶
Maintenant qu'on a une variable d'état, utilisons-la pour rafraîchir la vue.
Il doit y avoir quelque chose qui modifie cette variable d'état pour que la vue soit automatiquement rafraîchie.
Ce peut être du code que vous écrivez en réaction à une action de l'usager, par exemple lorsqu'il clique sur un bouton.
struct ContentView: View {
@State private var quantite: Int = 0
var body: some View {
VStack {
Text("Quantité: \(quantite)")
Button("Incrémenter", action: {
quantite += 1
})
// ...
}
}
}
Autre exemple : la variable d'état pourrait être modifiée par une valeur entrée par l'usager dans un contrôle de saisie, par exemple un TextField.
Remarquez l'utilisation du $ devant le nom de la variable d'état. Ceci ajoute une liaison (binding), ce qui signifie que la valeur entrée dans le TextField modifiera la variable d'état et vice-versa.
Utiliser une variable d'état¶
Les variables d'état seront souvent affichées directement dans l'écran, comme dans l'exemple présenté plus haut qui affiche une quantité.
Dans d'autres cas, elles pourront être utilisées dans une condition afin de moduler ce qui est affiché et comment les choses sont affichées dans la vue.
Voici quelques exemples qui pourraient répondre à vos besoins. J'ai utilisé ici une variable d'état booléenne.
Button(action: {
maVariableDEtat.toggle()
}) {
Text("Cliquez ici")
}
.alert("Bonjour!", isPresented: $maVariableDEtat) {
}
Dans cet exemple, la valeur de la variable d’état détermine si l’alerte est affichée ou non.
Pour plus d'information¶
« SwiftUI State (vidéo) ». Ray Wenderlich. https://www.raywenderlich.com/17493408-your-first-ios-and-swiftui-app-an-app-from-scratch/lessons/12
« Structure State ». Apple. https://developer.apple.com/documentation/swiftui/state
« A guide to SwiftUI’s state management system ». Swift by Sundell. https://www.swiftbysundell.com/articles/swiftui-state-management-guide/
« Safely Updating The View State ». The SwiftUI Lab. https://swiftui-lab.com/state-changes/