Aller au contenu

Convertisseurs

Transformer une valeur entre le ViewModel et la vue.

flowchart LR
  VM["ViewModel<br/>Taille = 1 536 000 (long)"] -- "Convert()" --> CV["TailleFichierConverter"] --> V["Vue<br/>« 1,5 Mo »"]
  V -. "ConvertBack()<br/>(TwoWay uniquement)" .-> VM

Convertisseurs intégrés

<!-- null → false, sinon true -->
<Border IsVisible="{Binding Selection, Converter={x:Static ObjectConverters.IsNotNull}}" />
<Border IsVisible="{Binding Selection, Converter={x:Static ObjectConverters.IsNull}}" />

<!-- chaîne vide ou null -->
<TextBlock IsVisible="{Binding Erreur, Converter={x:Static StringConverters.IsNotNullOrEmpty}}" />

Tip

Pour les booléens, l'opérateur ! suffit souvent : IsVisible="{Binding !EstVide}".

Convertisseur en une ligne

public static class Convertisseurs
{
    public static readonly FuncValueConverter<decimal, IBrush> MontantVersCouleur =
        new(m => m < 0 ? Brushes.Crimson : Brushes.SeaGreen);

    public static readonly FuncValueConverter<string?, string> Initiales =
        new(nom => string.Concat((nom ?? "").Split(' ', StringSplitOptions.RemoveEmptyEntries)
                                            .Select(m => char.ToUpper(m[0]))));
}
Aperçu · même convertisseur, valeurs différentes
1 250,00 €-42,50 €AL
<TextBlock Text="{Binding Solde, StringFormat='{}{0:C}'}"
           Foreground="{Binding Solde, Converter={x:Static local:Convertisseurs.MontantVersCouleur}}" />

<TextBlock Text="{Binding Nom, Converter={x:Static local:Convertisseurs.Initiales}}" />

IValueConverter complet

using System.Globalization;
using Avalonia.Data.Converters;

public class TailleFichierConverter : IValueConverter
{
    private static readonly string[] Unites = { "o", "Ko", "Mo", "Go", "To" };

    public object? Convert(object? value, Type targetType, object? parameter, CultureInfo culture)
    {
        if (value is not long octets) return null;
        double taille = octets;
        var i = 0;
        while (taille >= 1024 && i < Unites.Length - 1) { taille /= 1024; i++; }
        return $"{taille:0.#} {Unites[i]}";
    }

    public object? ConvertBack(object? value, Type targetType, object? parameter, CultureInfo culture)
        => throw new NotSupportedException();
}
<Window.Resources>
  <local:TailleFichierConverter x:Key="TailleFichier" />
</Window.Resources>

<TextBlock Text="{Binding Taille, Converter={StaticResource TailleFichier}}" />

Avec paramètre

public class EgalConverter : IValueConverter
{
    public object? Convert(object? value, Type t, object? parameter, CultureInfo c)
        => Equals(value?.ToString(), parameter?.ToString());

    public object? ConvertBack(object? value, Type t, object? parameter, CultureInfo c)
        => value is true ? Enum.Parse(t, parameter!.ToString()!) : BindingOperations.DoNothing;
}

Boutons radio liés à une enum :

<StackPanel>
  <RadioButton Content="Carte" IsChecked="{Binding Paiement, Converter={StaticResource Egal}, ConverterParameter=Carte}" />
  <RadioButton Content="Virement" IsChecked="{Binding Paiement, Converter={StaticResource Egal}, ConverterParameter=Virement}" />
</StackPanel>

BindingOperations.DoNothing : ne rien écrire dans la source (bouton décoché).

MultiBinding

flowchart LR
  A["SousTotal"] --> M["MultiBinding<br/>+ Somme"]
  B["Livraison"] --> M
  C["Taxes"] --> M
  M --> T["« Total : 57,80 € »"]
public static readonly FuncMultiValueConverter<double, double> Somme =
    new(valeurs => valeurs.Sum());   // v12 : IReadOnlyList<double>
<TextBlock>
  <TextBlock.Text>
    <MultiBinding Converter="{x:Static local:Convertisseurs.Somme}" StringFormat="Total : {0:C}">
      <Binding Path="SousTotal" />
      <Binding Path="Livraison" />
      <Binding Path="Taxes" />
    </MultiBinding>
  </TextBlock.Text>
</TextBlock>

Combiner des booléens

<Button Content="Valider">
  <Button.IsEnabled>
    <MultiBinding Converter="{x:Static BoolConverters.And}">
      <Binding Path="FormulaireValide" />
      <Binding Path="!EstOccupe" />
    </MultiBinding>
  </Button.IsEnabled>
</Button>

BoolConverters.And / BoolConverters.Or.

Plutôt une propriété calculée ?

Souvent, une propriété du ViewModel est plus simple et testable qu'un convertisseur :

[ObservableProperty]
[NotifyPropertyChangedFor(nameof(NomComplet))]
public partial string Prenom { get; set; } = "";

public string NomComplet => $"{Prenom} {Nom}";

Convertisseur : logique purement visuelle, réutilisée (couleurs, tailles, icônes). Propriété calculée : logique propre à un écran.