Avalonia怎么在XAML中定义颜色和画刷 Avalonia资源字典使用

来源：这里教程网时间：2026-02-21 17:37:07 作者：

在Avalonia中，颜色和画刷属于资源（Resources），不是样式（Styles），必须定义在

ResourceDictionary

里，并通过

StaticResource

或

DynamicResource

引用。不能写在

Styles

块或样式文件中，否则会编译报错。

颜色和画刷要放在资源字典里

资源字典可以是独立文件（如

Colors.axaml

），也可以直接嵌入到

App.xaml

、

Window.xaml

等的

Resources

节内。关键点是：每个资源必须有

x:Key

，且类型要匹配。

SolidColorBrush
用
Color
构造，或直接绑定已定义的
Color
资源
Color
资源可单独定义，便于复用和主题切换支持
GradientBrush
、
ImageBrush
等，写法类似

示例（

Colors.axaml

）：

<ResourceDictionary xmlns="https://github.com/avaloniaui" 
                    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
  <Color x:Key="PrimaryColor">#FF5494E2</Color>
  <SolidColorBrush x:Key="PrimaryBrush" Color="{StaticResource PrimaryColor}"/>
  <SolidColorBrush x:Key="TextBrush" Color="#FF333333"/>
  <LinearGradientBrush x:Key="HeaderGradient" StartPoint="0,0" EndPoint="1,1">
    <GradientStop Offset="0" Color="#FFEEEEEE"/>
    <GradientStop Offset="1" Color="#FFDDDDDD"/>
  </LinearGradientBrush>
</ResourceDictionary>

在XAML中引用资源

只要资源字典已加载（通过

MergedDictionaries

或直接嵌入），就可以在任意控件属性中用

{StaticResource KeyName}

引用。

Background
、
Foreground
、
BorderBrush
等属性都支持画刷资源
Color
资源一般不直接用于控件属性，而是作为画刷的输入，或用于转换器参数若需随系统主题动态更新，改用
{ThemeResource KeyName}
（需配合
ThemeDictionaries
）

例如：

<TextBlock Text="标题" Foreground="{StaticResource TextBrush}" />
<Border Background="{StaticResource HeaderGradient}" />
<Button Background="{StaticResource PrimaryBrush}" Content="确定" />

合并资源字典的两种常用方式

资源字典需要被“引入”才生效。推荐集中管理，比如在

App.xaml

中统一合并：

直接合并（立即加载）：
<resourcedictionary.mergeddictionaries><resourcedictionary source="/Styles/Colors.axaml"></resourcedictionary></resourcedictionary.mergeddictionaries>
延迟加载（按需）：用
<resourceinclude source="..." x:key="MyColors"></resourceinclude>
，之后在代码中手动取出来赋值给
MergedDictionaries

注意路径写法：

/Styles/Colors.axaml

表示项目根目录下的相对路径；

avares://AppName/...

用于程序集内嵌资源。

配合主题自动切换颜色

如果希望颜色随亮色/暗色主题变化，要用

ThemeDictionaries

，而不是普通资源字典：

<SolidColorBrush x:Key="AccentBrush">
  <SolidColorBrush.ThemeDictionaries>
    <ResourceDictionary Theme="Light">
      <SolidColorBrush x:Key="AccentBrush" Color="#FF5494E2"/>
    </ResourceDictionary>
    <ResourceDictionary Theme="Dark">
      <SolidColorBrush x:Key="AccentBrush" Color="#FF3A7EBF"/>
    </ResourceDictionary>
  </SolidColorBrush.ThemeDictionaries>
</SolidColorBrush>

这样在