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]))));
}
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.