ControlTheme et templates¶
Un ControlTheme définit l'apparence complète d'un contrôle, template compris.
Style ou ControlTheme ?¶
| Besoin | Outil |
|---|---|
| Changer quelques propriétés (couleur, marge…) | Style + classe |
| Une variante nommée d'un contrôle existant | ControlTheme avec BasedOn |
| Redessiner entièrement un contrôle | ControlTheme avec Template |
flowchart TB
subgraph CT["ControlTheme (1 seul par contrôle)"]
direction TB
SE["Setters<br/>Background, Padding…"]
TP["Template"]
ST["Styles internes ^:pointerover…"]
end
subgraph S["Styles (plusieurs, se cumulent)"]
S1["Button.accent"]
S2["Button:disabled"]
end
CT --> BTN["Button affiché"]
S --> BTN
Un contrôle a un seul ControlTheme (sa « tenue de base ») ; les styles s'empilent par-dessus.
Variante basée sur le thème Fluent¶
App.axaml
<Application.Resources>
<ControlTheme x:Key="BoutonPilule" TargetType="Button"
BasedOn="{StaticResource {x:Type Button}}">
<Setter Property="CornerRadius" Value="999" />
<Setter Property="Padding" Value="18,8" />
<Setter Property="Background" Value="#6D28D9" />
<Setter Property="Foreground" Value="White" />
<Style Selector="^:pointerover /template/ ContentPresenter#PART_ContentPresenter">
<Setter Property="Background" Value="#5B21B6" />
<Setter Property="Foreground" Value="White" />
</Style>
</ControlTheme>
</Application.Resources>
Template complet¶
<ControlTheme x:Key="BoutonLien" TargetType="Button">
<Setter Property="Foreground" Value="#6D28D9" />
<Setter Property="Background" Value="Transparent" />
<Setter Property="Cursor" Value="Hand" />
<Setter Property="Template">
<ControlTemplate>
<ContentPresenter x:Name="PART_ContentPresenter"
Content="{TemplateBinding Content}"
ContentTemplate="{TemplateBinding ContentTemplate}"
Foreground="{TemplateBinding Foreground}"
Background="{TemplateBinding Background}"
Padding="{TemplateBinding Padding}" />
</ControlTemplate>
</Setter>
<Style Selector="^:pointerover">
<Setter Property="Foreground" Value="#4C1D95" />
</Style>
</ControlTheme>
{TemplateBinding X} reprend la valeur de la propriété X du contrôle.
flowchart LR
subgraph B["Button (ce que vous écrivez)"]
P1["Content = 'En savoir plus'"]
P2["Foreground = #6D28D9"]
P3["Padding = 0"]
end
subgraph T["ControlTemplate (ce qui est dessiné)"]
CP["ContentPresenter"]
end
P1 -- TemplateBinding --> CP
P2 -- TemplateBinding --> CP
P3 -- TemplateBinding --> CP
Remplacer le thème par défaut d'un type¶
Clé = le type : s'applique à tous les contrôles de ce type.
<Application.Resources>
<ControlTheme x:Key="{x:Type Separator}" TargetType="Separator">
<Setter Property="Template">
<ControlTemplate>
<Border Height="1" Margin="0,8" Background="#E5E7EB" />
</ControlTemplate>
</Setter>
</ControlTheme>
</Application.Resources>
Badge : ContentControl redessiné¶
<ControlTheme x:Key="Badge" TargetType="ContentControl">
<Setter Property="Background" Value="#EDE9FE" />
<Setter Property="Foreground" Value="#5B21B6" />
<Setter Property="Padding" Value="8,2" />
<Setter Property="FontSize" Value="12" />
<Setter Property="FontWeight" Value="SemiBold" />
<Setter Property="Template">
<ControlTemplate>
<Border Background="{TemplateBinding Background}" CornerRadius="999"
Padding="{TemplateBinding Padding}">
<ContentPresenter Content="{TemplateBinding Content}" />
</Border>
</ControlTemplate>
</Setter>
<Style Selector="^.succes">
<Setter Property="Background" Value="#D1FAE5" />
<Setter Property="Foreground" Value="#065F46" />
</Style>
</ControlTheme>
<StackPanel Orientation="Horizontal" Spacing="6">
<ContentControl Theme="{StaticResource Badge}" Content="Nouveau" />
<ContentControl Theme="{StaticResource Badge}" Classes="succes" Content="Payé" />
</StackPanel>
NouveauPayé
Appliquer un thème via un style¶
<Style Selector="Button.pilule">
<Setter Property="Theme" Value="{StaticResource BoutonPilule}" />
</Style>
<Button Classes="pilule" Content="Raccourci" />
Template d'une CheckBox personnalisée¶
<ControlTheme x:Key="CaseRonde" TargetType="CheckBox">
<Setter Property="Template">
<ControlTemplate>
<StackPanel Orientation="Horizontal" Spacing="8" Background="Transparent">
<Border x:Name="Cercle" Width="20" Height="20" CornerRadius="10"
BorderThickness="2" BorderBrush="#9CA3AF">
<Ellipse x:Name="Point" Width="10" Height="10" Fill="#6D28D9" IsVisible="False" />
</Border>
<ContentPresenter Content="{TemplateBinding Content}" VerticalAlignment="Center" />
</StackPanel>
</ControlTemplate>
</Setter>
<Style Selector="^:checked /template/ Ellipse#Point">
<Setter Property="IsVisible" Value="True" />
</Style>
<Style Selector="^:checked /template/ Border#Cercle">
<Setter Property="BorderBrush" Value="#6D28D9" />
</Style>
</ControlTheme>
Partir de l'existant
Copiez le ControlTheme Fluent du contrôle depuis les sources
(src/Avalonia.Themes.Fluent/Controls/*.xaml) et modifiez-le : vous gardez tous les états.