Aller au contenu

Ressources

Nommer une valeur une fois, la réutiliser partout.

Déclarer et utiliser

<Window.Resources>
  <SolidColorBrush x:Key="Marque" Color="#6D28D9" />
  <CornerRadius x:Key="Arrondi">8</CornerRadius>
  <Thickness x:Key="EspaceCarte">16</Thickness>
  <x:Double x:Key="TailleTitre">24</x:Double>
  <x:String x:Key="NomApp">Mon application</x:String>
</Window.Resources>

<Border Background="{StaticResource Marque}"
        CornerRadius="{StaticResource Arrondi}"
        Padding="{StaticResource EspaceCarte}">
  <TextBlock Text="{StaticResource NomApp}" FontSize="{StaticResource TailleTitre}" />
</Border>

StaticResource ou DynamicResource ?

sequenceDiagram
  participant C as Contrôle
  participant R as Ressource "Fond"
  Note over C,R: Au chargement
  R->>C: StaticResource : copie la valeur (blanc)
  R->>C: DynamicResource : s'abonne (blanc)
  Note over R: Passage en mode sombre : Fond = noir
  R--xC: StaticResource : rien ne change (reste blanc)
  R->>C: DynamicResource : reçoit noir
StaticResource DynamicResource
Résolu une fois, au chargement à chaque changement
Suit le thème clair/sombre non oui
Performance meilleure légèrement moindre
<!-- Change avec le thème -->
<Border Background="{DynamicResource SystemControlBackgroundAltHighBrush}" />

Règle simple : DynamicResource pour les couleurs, StaticResource pour le reste.

Recherche des ressources

Avalonia remonte l'arbre : contrôle → parents → fenêtre → Application → thème. La première trouvée gagne.

flowchart BT
  B["Border<br/>{DynamicResource Marque}"] --> SP["StackPanel.Resources<br/>Marque = Orange ✔ trouvée ici"]
  SP -.-> W["Window.Resources"]
  W -.-> A["Application.Resources<br/>Marque = #6D28D9 (masquée)"]
  A -.-> T["Thème Fluent"]
<StackPanel>
  <StackPanel.Resources>
    <SolidColorBrush x:Key="Marque" Color="Orange" />   <!-- masque la ressource globale -->
  </StackPanel.Resources>
  <Border Background="{DynamicResource Marque}" />     <!-- orange -->
</StackPanel>

Ressources selon le thème

App.axaml
<Application.Resources>
  <ResourceDictionary>
    <ResourceDictionary.ThemeDictionaries>
      <ResourceDictionary x:Key="Light">
        <SolidColorBrush x:Key="FondCarte" Color="White" />
        <SolidColorBrush x:Key="TexteSecondaire" Color="#6B7280" />
      </ResourceDictionary>
      <ResourceDictionary x:Key="Dark">
        <SolidColorBrush x:Key="FondCarte" Color="#1F1F2E" />
        <SolidColorBrush x:Key="TexteSecondaire" Color="#9CA3AF" />
      </ResourceDictionary>
    </ResourceDictionary.ThemeDictionaries>
  </ResourceDictionary>
</Application.Resources>
<Border Background="{DynamicResource FondCarte}">
  <TextBlock Foreground="{DynamicResource TexteSecondaire}" Text="S'adapte au thème" />
</Border>
Aperçu · même XAML, deux thèmes
S'adapte au thème
Light : FondCarte = White
S'adapte au thème
Dark : FondCarte = #1F1F2E

Fichier de ressources séparé

Styles/Couleurs.axaml
<ResourceDictionary xmlns="https://github.com/avaloniaui"
                    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
  <Color x:Key="Violet500">#8B5CF6</Color>
  <Color x:Key="Violet700">#6D28D9</Color>
  <SolidColorBrush x:Key="Marque" Color="{StaticResource Violet700}" />
</ResourceDictionary>
App.axaml
<Application.Resources>
  <ResourceDictionary>
    <ResourceDictionary.MergedDictionaries>
      <ResourceInclude Source="/Styles/Couleurs.axaml" />
      <ResourceInclude Source="/Styles/Tailles.axaml" />
    </ResourceDictionary.MergedDictionaries>
  </ResourceDictionary>
</Application.Resources>

Ressources dans un style

<Style Selector="Border.carte">
  <Setter Property="Background" Value="{DynamicResource FondCarte}" />
</Style>

Surcharger une ressource Fluent

App.axaml
<Application.Resources>
  <!-- Arrondi de tous les contrôles -->
  <CornerRadius x:Key="ControlCornerRadius">8</CornerRadius>
  <!-- Fond des boutons au survol -->
  <SolidColorBrush x:Key="ButtonBackgroundPointerOver" Color="#EDE9FE" />
</Application.Resources>

Tip

Les noms des ressources Fluent sont visibles dans les outils de développement (F12, onglet Resources) ou dans les sources d'Avalonia (src/Avalonia.Themes.Fluent).

Lire / modifier en C

// Lecture
if (this.TryFindResource("Marque", ActualThemeVariant, out var valeur) && valeur is IBrush pinceau)
    Debug.WriteLine(pinceau);

// Modification : les DynamicResource se mettent à jour
Application.Current!.Resources["Marque"] = new SolidColorBrush(Color.Parse("#DB2777"));

Templates en ressource

<Window.Resources>
  <DataTemplate x:Key="ModeleContact" x:DataType="m:Contact">
    <TextBlock Text="{Binding Nom}" />
  </DataTemplate>
</Window.Resources>

<ListBox ItemTemplate="{StaticResource ModeleContact}" ItemsSource="{Binding Contacts}" />