WinUI中Lightweight Styling（轻量级样式）的规范使用及端到端示例

WinUI的轻量级样式允许通过覆盖控件内置的命名资源，快速定制控件外观，无需重写完整模板。针对你提出的核心问题，结合无障碍要求与标准资源使用规范，以下是端到端的实践方案：

一、核心问题解答 #

1. 深色/高对比度主题的适配 #

在ThemeDictionaries中为不同主题添加对应的ResourceDictionary节点，系统会根据当前自动切换的主题（浅色/深色/高对比度）加载对应资源。高对比度模式下必须使用系统提供的高对比度专用资源，确保视觉障碍用户的可访问性。

2. 无需自定义纯色画刷，可直接使用WinUI内置资源 #

完全可以复用WinUI内置的主题画刷资源（如SystemControlBackgroundAccentBrush、SystemControlForegroundBaseHighBrush等），这些资源已经适配了主题切换与无障碍要求，比自定义纯色画刷更规范。

3. 非主题相关资源的覆盖 #

对于Thickness这类不随主题变化的资源，直接在ResourceDictionary的根节点定义即可，不需要嵌套在ThemeDictionaries中，全局生效。

二、完整端到端示例 #

<Page.Resources>
    <ResourceDictionary>
        <!-- 非主题相关资源：全局覆盖按钮边框厚度 -->
        <Thickness x:Key="ButtonBorderThickness">2</Thickness>

        <!-- 多主题资源配置 -->
        <ResourceDictionary.ThemeDictionaries>
            <!-- 浅色主题 -->
            <ResourceDictionary x:Key="Light">
                <StaticResource x:Key="ButtonBackground" ResourceKey="SystemControlBackgroundAccentBrush"/>
                <StaticResource x:Key="ButtonForeground" ResourceKey="SystemControlForegroundBaseHighBrush"/>
                <StaticResource x:Key="ButtonBorderBrush" ResourceKey="SystemControlForegroundAccentBrush"/>
            </ResourceDictionary>

            <!-- 深色主题 -->
            <ResourceDictionary x:Key="Dark">
                <StaticResource x:Key="ButtonBackground" ResourceKey="SystemControlBackgroundAccentBrush"/>
                <StaticResource x:Key="ButtonForeground" ResourceKey="SystemControlForegroundBaseHighBrush"/>
                <StaticResource x:Key="ButtonBorderBrush" ResourceKey="SystemControlForegroundAccentBrush"/>
            </ResourceDictionary>

            <!-- 高对比度主题：使用系统高对比度专用资源 -->
            <ResourceDictionary x:Key="HighContrast">
                <StaticResource x:Key="ButtonBackground" ResourceKey="SystemColorHighlightBrush"/>
                <StaticResource x:Key="ButtonForeground" ResourceKey="SystemColorHighlightTextBrush"/>
                <StaticResource x:Key="ButtonBorderBrush" ResourceKey="SystemColorButtonBorderBrush"/>
            </ResourceDictionary>
        </ResourceDictionary.ThemeDictionaries>
    </ResourceDictionary>
</Page.Resources>

<!-- 示例按钮：自动应用上述轻量级样式 -->
<Button Content="自定义样式按钮" Margin="20"/>

三、示例说明 #

• 多主题适配：Light/Dark主题复用WinUI accent系列资源，保证风格统一；HighContrast主题使用系统高对比度专用资源，符合无障碍标准，系统切换主题时自动生效。
• 内置资源复用：通过StaticResource引用WinUI内置资源，避免手动定义颜色，确保主题切换时的一致性。
• 非主题资源：ButtonBorderThickness直接定义在根节点，所有按钮都会使用这个边框厚度，不受主题影响。

内容的提问来源于stack exchange，提问作者citelao