Aller au contenu

Les bases du XAML

Une balise = un objet. Un attribut = une propriété. Un enfant = le contenu.

Balise, attribut, contenu

Aperçu
<Button Content="Valider" Width="120" />
var button = new Button { Content = "Valider", Width = 120 };

Syntaxe « propriété-élément »

Quand une valeur ne tient pas dans un attribut :

Aperçu
Dégradé
<Button>
  <Button.Background>
    <LinearGradientBrush StartPoint="0%,0%" EndPoint="100%,0%">
      <GradientStop Offset="0" Color="#8B5CF6" />
      <GradientStop Offset="1" Color="#6D28D9" />
    </LinearGradientBrush>
  </Button.Background>
  Dégradé
</Button>

Contenu implicite

Le XAML décrit un arbre d'objets : chaque balise imbriquée devient un enfant.

flowchart TB
  W["Window"] -- Content --> S["StackPanel"]
  S -- "Children[0]" --> T["TextBox"]
  S -- "Children[1]" --> B["Button"]
  S -- "Children[2]" --> TB["TextBlock"]
  B -- Content --> STR["'Saluer'"]
<!-- Ces deux écritures sont identiques -->
<Border><TextBlock Text="A" /></Border>
<Border><Border.Child><TextBlock Text="A" /></Border.Child></Border>
Contrôle Propriété de contenu
Window, Button, UserControl Content (un seul objet)
Border, Viewbox Child
StackPanel, Grid… Children (plusieurs)
TextBlock Inlines
ListBox, ComboBox Items

Namespaces

<Window xmlns="https://github.com/avaloniaui"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:vm="using:MonApp.ViewModels"
        xmlns:ctrl="using:MonApp.Controls"
        xmlns:sys="using:System">

  <StackPanel>
    <ctrl:Badge Text="Nouveau" />
    <TextBlock Text="{x:Static sys:Environment.MachineName}" />
  </StackPanel>
</Window>

using: pointe vers un namespace C# de votre projet ou d'une référence.

Nommer un élément

<TextBox x:Name="Saisie" />
<Button Content="Effacer" Click="OnEffacer" />
private void OnEffacer(object? sender, RoutedEventArgs e) => Saisie.Clear();

Avalonia génère un champ Saisie dans la classe partielle.

Extensions de balisage

Entre accolades : une valeur calculée.

<TextBlock Text="{Binding Titre}" />                        <!-- liaison -->
<Border Background="{DynamicResource MarqueBrush}" />        <!-- ressource -->
<TextBlock Text="{x:Static local:Constantes.Version}" />     <!-- membre statique -->
<ContentControl Content="{x:Null}" />                        <!-- null -->
<TextBlock Tag="{x:Type Button}" />                          <!-- type -->
<TextBlock Text="{}{0} articles" />                          <!-- échappe l'accolade -->

Propriétés attachées

Propriétés définies par un parent, posées sur l'enfant.

flowchart LR
  E["TextBlock<br/>Grid.Column='1'"] -- "« place-moi en colonne 1 »" --> G["Grid<br/>lit Grid.Column de chaque enfant"]

Le TextBlock n'a pas de propriété Column : c'est une info pour la Grid, rangée sur l'enfant.

<Grid ColumnDefinitions="*,*">
  <TextBlock Grid.Column="1" Text="À droite" />
</Grid>

<Canvas>
  <Ellipse Canvas.Left="40" Canvas.Top="20" Width="30" Height="30" Fill="Orange" />
</Canvas>

<Button ToolTip.Tip="Enregistrer le document" Content="💾" />

Raccourcis de syntaxe

<!-- Couleurs -->
<Border Background="Red" />
<Border Background="#FF6D28D9" />          <!-- ARGB -->
<Border Background="#806D28D9" />          <!-- 50 % d'opacité -->

<!-- Épaisseurs : uniforme / horizontal,vertical / gauche,haut,droite,bas -->
<Border Margin="8" Padding="16,8" BorderThickness="0,0,0,1" />

<!-- Coins arrondis -->
<Border CornerRadius="8" />
<Border CornerRadius="8,8,0,0" />

<!-- Grille -->
<Grid ColumnDefinitions="Auto,*,2*" RowDefinitions="Auto,*" />

Classes CSS-like

<Button Classes="accent" Content="Principal" />
<Button Classes="danger large" Content="Supprimer" />
Aperçu · avec un style pour .danger et .large

Voir Styles pour cibler ces classes.

Commentaires et caractères spéciaux

<!-- Commentaire -->
<TextBlock Text="Prix &lt; 10 &amp; stock &gt; 0" />
<TextBlock Text="Ligne 1&#x0a;Ligne 2" />   <!-- retour à la ligne -->

Créer l'interface en C# pur

public MainWindow()
{
    var texte = new TextBlock { Text = "0 clic" };
    var compteur = 0;

    var bouton = new Button { Content = "Cliquer" };
    bouton.Click += (_, _) => texte.Text = $"{++compteur} clic(s)";

    Content = new StackPanel
    {
        Margin = new Thickness(20),
        Spacing = 10,
        Children = { bouton, texte }
    };
}