syncfusion-maui-theming

Syncfusion .NET MAUI 中的主题设置

在所有 Syncfusion .NET MAUI 组件中应用、自定义和创建主题的完整指南。

何时使用此技能

在以下情况下使用此技能：

• 应用浅色或深色主题（MaterialLight、MaterialDark、CupertinoLight、CupertinoDark）
• 在应用中配置 SyncfusionThemeResourceDictionary
• 在运行时动态切换主题
• 覆盖特定控件的默认主题颜色
• 自定义控件专属的样式和外观
• 从头开始创建完全自定义的主题
• 在所有组件中应用统一的品牌风格
• 实现与系统主题同步
• 排查与主题相关的样式问题
• 查找特定 UI 元素的主题键

组件概览

Syncfusion 的主题系统通过 SyncfusionThemeResourceDictionary 提供统一的方式来设置所有 MAUI 组件的样式。这种集中式方案具有以下优势：

• 自动合并：自动包含控件专属样式
• 外观一致：所有组件的外观统一
• 轻松切换主题：在运行时更改主题
• 灵活自定义：覆盖特定键或创建自定义主题
• 平台主题：支持 Material 和 Cupertino 设计

可用主题：

• MaterialLight - Material Design 浅色主题
• MaterialDark - Material Design 深色主题
• CupertinoLight - Apple iOS 浅色主题
• CupertinoDark - Apple iOS 深色主题

文档与导航指南

基本主题设置

📄 阅读： references/applying-themes.md

• 安装和配置 SyncfusionThemeResourceDictionary
• 可用主题选项（Material、Cupertino）
• 在 App.xaml 中设置主题
• 自动合并控件样式
• 应用平台专属主题
• VisualTheme 属性的用法

运行时主题切换

📄 阅读： references/theme-switching.md

• 在运行时动态更改主题
• 用于主题管理的 ViewModel 模式
• 移除和添加主题字典
• 持久化用户偏好
• 与系统/OS 主题同步
• 边缘情况和故障排除

自定义默认主题

📄 阅读： references/overriding-themes.md

• 覆盖特定主题颜色键
• 自定义控件专属的键
• 主键与控件专属键
• 合并字典的图层顺序
• 选择性自定义策略
• 常见品牌风格应用场景

创建自定义主题

📄 阅读： references/creating-custom-themes.md

• 从头开始构建主题
• 主题键注册模式
• 定义自定义配色方案
• 完整的主题实现
• 企业品牌主题
• 无障碍主题（高对比度）

主题键参考

📄 阅读： references/theme-keys-reference.md

• 键命名约定
• 结构：Sf{ControlName}{Element}{Property}
• 按类别划分的常用控件键
• 查找任意控件的键
• 官方文档参考