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>
S'adapte au thème
Light : FondCarte = WhiteS'adapte au thème
Dark : FondCarte = #1F1F2EFichier 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"));