Binding & MVVM¶
La vue affiche, le ViewModel décide. Le binding relie les deux.
flowchart LR
V["Vue (.axaml)"] -- "binding" --> VM["ViewModel (C#)"]
VM -- "notifications" --> V
VM --> M["Modèle / services"]
| Couche | Contient | Connaît |
|---|---|---|
| Vue | XAML, animations, code purement visuel | le ViewModel (via DataContext) |
| ViewModel | état de l'écran, commandes, validation | le modèle, les services |
| Modèle | données, règles métier, accès aux données | rien de l'UI |
L'exemple minimal¶
Paquet recommandé : CommunityToolkit.Mvvm (inclus par le template avalonia.mvvm).
0
sequenceDiagram
participant B as Button (vue)
participant VM as CompteurViewModel
participant T as TextBlock (vue)
B->>VM: AjouterCommand.Execute()
VM->>VM: Valeur++
VM-->>T: PropertyChanged("Valeur")
T->>VM: relit Valeur → affiche 1
La vue ne modifie jamais le texte elle-même : elle observe le ViewModel.
<UserControl xmlns="https://github.com/avaloniaui"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:vm="using:MonApp.ViewModels"
x:Class="MonApp.Views.CompteurView"
x:DataType="vm:CompteurViewModel">
<StackPanel Spacing="8" Margin="16">
<TextBlock Text="{Binding Valeur}" FontSize="32" />
<Button Content="+1" Command="{Binding AjouterCommand}" />
</StackPanel>
</UserControl>
DataContext¶
Le DataContext se transmet aux enfants. Chaque {Binding X} cherche X dans le DataContext courant.
flowchart TB
W["Window<br/>DataContext = MainViewModel"] --> S1["StackPanel<br/>(hérite : MainViewModel)"]
S1 --> T1["TextBlock {Binding Titre}<br/>→ MainViewModel.Titre"]
S1 --> S2["StackPanel DataContext={Binding Client}<br/>(change : Client)"]
S2 --> T2["TextBlock {Binding Nom}<br/>→ Client.Nom"]
<StackPanel> <!-- DataContext = MainViewModel -->
<TextBlock Text="{Binding Titre}" /> <!-- MainViewModel.Titre -->
<StackPanel DataContext="{Binding Client}"> <!-- DataContext = MainViewModel.Client -->
<TextBlock Text="{Binding Nom}" /> <!-- Client.Nom -->
</StackPanel>
</StackPanel>
Données pour l'aperçu¶
<UserControl xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
mc:Ignorable="d"
x:DataType="vm:CompteurViewModel">
<Design.DataContext>
<vm:CompteurViewModel Valeur="42" />
</Design.DataContext>
<!-- … -->
</UserControl>
Utilisé uniquement par le prévisualiseur.
Pages de la section¶
- Bases du binding — modes, chemins, formats, liaison entre éléments
- Compiled bindings —
x:DataType, le défaut en v12 - Convertisseurs — transformer une valeur
- MVVM Toolkit —
[ObservableProperty], notifications - Commandes —
[RelayCommand], async,CanExecute - Collections —
ObservableCollection, filtrer, trier - Validation — erreurs de saisie
- DataTemplates et navigation — une vue par ViewModel
- Injection de dépendances — services et ViewModels
- Exemple complet — une liste de tâches de A à Z