Aller au contenu

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).

dotnet add package CommunityToolkit.Mvvm
Aperçu · cliquez +1
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.

using CommunityToolkit.Mvvm.ComponentModel;
using CommunityToolkit.Mvvm.Input;

namespace MonApp.ViewModels;

public partial class CompteurViewModel : ObservableObject
{
    [ObservableProperty]
    public partial int Valeur { get; set; }

    [RelayCommand]
    private void Ajouter() => Valeur++;
}
<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>
desktop.MainWindow = new MainWindow
{
    DataContext = new CompteurViewModel()
};

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