Avalonia 使用 Fluent 主题非常简单,核心是通过
FluentTheme控件和资源字典注入实现,主题切换则依赖动态替换
Styles集合中的主题资源。
引入 Fluent 主题资源
在应用启动时(通常在
App.xaml或
Program.cs中),需将 Fluent 主题的样式资源加载进全局
Styles。Avalonia 11+ 推荐使用
FluentTheme控件配合
FluentColors,但最直接的方式是引用预编译的 Fluent 资源字典: 确保已安装
Avalonia.Themes.FluentNuGet 包(版本需与 Avalonia 主版本匹配,如 Avalonia 11 对应
Avalonia.Themes.Fluent 11.x) 在
App.xaml的
<application.styles></application.styles>中添加:
或显式引用资源字典(兼容性更强):
运行时切换主题模式(Light/Dark)
Fluent 主题支持通过
FluentTheme.Mode属性动态切换明暗模式。推荐做法是把
FluentTheme实例放在根窗口或
App级别,并绑定或手动更新其
Mode属性: 在主窗口 XAML 中定义
FluentTheme并命名,例如:
Theme.Mode = ThemeMode.Dark; 或 Theme.Mode = ThemeMode.Light; 若使用 MVVM,可将
Mode绑定到 ViewModel 的
ThemeMode属性,并触发通知
自定义主题颜色(强调色、圆角等)
Fluent 主题允许覆盖系统级颜色和形状参数,无需重写全部样式。可在
FluentTheme内部设置属性: AccentColor:设置主强调色(如蓝色按钮、选中状态色) CornerRadius:统一控件圆角(默认
4,可设为
0实现直角风格) IsHighContrast:启用高对比度适配(辅助功能场景) 示例:
多主题共存与按需加载(进阶)
如需支持自定义主题(如深蓝、橙色主题)与 Fluent 并存,建议用资源字典切换而非直接替换
FluentTheme: 将不同主题封装为独立
ResourceDictionary(如
BlueTheme.xaml) 在运行时清空
Application.Current.Styles,再插入对应主题资源:
Application.Current.Styles.Clear();
Application.Current.Styles.Add(new StyleInclude(new Uri("avares://MyApp/Themes/BlueTheme.xaml"))); 注意:这种方式会丢弃
FluentTheme的自动模式响应能力,需自行管理明暗逻辑
基本上就这些。Fluent 主题集成不复杂但容易忽略 NuGet 版本匹配和资源加载时机,只要确保包版本一致、样式注入位置正确,切换就能即时生效。
