基于MaterialDesignInXAML的WPF应用如何设置设计时暗黑模式
WPF MaterialDesign 设计时暗黑模式预览配置
根因
Visual Studio XAML设计器使用独立的设计时上下文加载预览资源,仅会解析带d:前缀的设计时标记,不会主动应用App.xaml中定义的运行时主题配置。
官方Demo可直接预览暗黑效果,本质是在每个用于设计预览的XAML根元素上追加了专用设计时资源引用,这部分配置不在App.xaml中,因此逐行对比App.xaml时无法发现差异。
实现步骤
- 在需要预览暗黑模式的窗口/用户控件XAML根元素上,补充Blend设计时命名空间引用:
xmlns:d="http://schemas.microsoft.com/expression/blend/2008" xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" mc:Ignorable="d" - 在根元素的资源集合中,追加仅设计时生效的暗黑主题配置,参数匹配运行时使用的主色、辅色,保证预览效果和实际运行一致:
<Window.Resources> <ResourceDictionary> <ResourceDictionary.MergedDictionaries> <!-- 标记为设计时专用,不影响运行时逻辑 --> <materialDesign:BundledTheme BaseTheme="Dark" PrimaryColor="DeepPurple" SecondaryColor="Lime" d:IsDesignTimeOnly="True" /> <ResourceDictionary Source="pack://application:,,,/MaterialDesignThemes.Wpf;component/Themes/MaterialDesignTheme.Defaults.xaml" d:IsDesignTimeOnly="True" /> </ResourceDictionary.MergedDictionaries> </ResourceDictionary> </Window.Resources> - 配置完成后,设计器会自动加载暗黑主题资源,直接显示暗黑背景、前景色匹配的预览效果。
适配说明
- 该配置完全不影响现有运行时动态切主题逻辑:带
d:IsDesignTimeOnly="True"标记的资源仅在VS设计器上下文解析,应用实际启动时会被忽略 - 若需要全局对所有页面生效设计时暗黑预览,可将上述设计时资源合并到App.xaml的资源集合中,保持
d:IsDesignTimeOnly="True"标记即可 - 若设计器加载异常,可删除项目下的
bin、obj文件夹,还原NuGet包后重启Visual Studio,清除旧的设计时缓存
注意事项
- 禁止直接替换App.xaml中现有的运行时Light主题配置,否则会强制将应用默认启动主题改为暗黑,破坏现有动态切主题功能
- 需保证引用的MaterialDesignThemes.Wpf包版本与官方Demo使用版本一致,低版本存在设计时主题解析bug
- .NET Core 3.1项目需搭配Visual Studio 16.8及以上版本使用,旧版本设计器对设计时资源的解析存在兼容性问题
内容的提问来源于stack exchange,提问作者Kelly
相关产品推荐
相关产品推荐

