Aller au contenu

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>
<Button Theme="{StaticResource BoutonPilule}" Content="S'inscrire" />
Aperçu · survolez

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
Aperçu · un bouton qui ressemble à un lien

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>
Aperçu
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>
Aperçu · cliquez

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.