Les bases du XAML¶
Une balise = un objet. Un attribut = une propriété. Un enfant = le contenu.
Balise, attribut, contenu¶
Syntaxe « propriété-élément »¶
Quand une valeur ne tient pas dans un attribut :
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¶
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" />
Voir Styles pour cibler ces classes.
Commentaires et caractères spéciaux¶
<!-- Commentaire -->
<TextBlock Text="Prix < 10 & stock > 0" />
<TextBlock Text="Ligne 1
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 }
};
}