关于 syncfusion-maui-toolkit-theming
面向 Syncfusion .NET MAUI 应用开发者的主题设置与定制指南,涵盖内置 Material 主题、运行时切换、样式覆盖和自定义主题创建。也介绍系统主题同步与主题键查找。
主要功能
- 01配置统一主题资源字典
- 02应用 Material 浅色与深色主题
- 03运行时切换并同步系统主题
- 04覆盖控件样式与颜色键
- 05创建自定义主题并查找主题键
适用场景
- 01为应用应用浅色或深色主题
- 02根据用户偏好动态切换主题
- 03统一组件外观并设置品牌样式
- 04创建高对比度或企业自定义主题
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ syncfusion/ maui-toolkit-ui-components-skills --skill syncfusion-maui-toolkit-theming安装后在 Claude Code 中输入/syncfusion-maui-toolkit-theming确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/applying-themes.mdcreating-custom-themes.mdoverriding-themes.mdtheme-keys-reference.mdtheme-switching.md详细介绍
Syncfusion .NET MAUI 中的主题
在所有 Syncfusion .NET MAUI 组件中应用、自定义和创建主题的完整指南。
何时使用此技能
在以下情况下使用此技能:
- 应用浅色或深色主题(MaterialLight、MaterialDark)
- 在应用中配置
SyncfusionThemeResourceDictionary - 在运行时动态切换主题
- 覆盖特定控件的默认主题颜色
- 自定义控件专属的样式和外观
- 从头开始创建完全自定义的主题
- 在所有组件中应用一致的品牌风格
- 实现系统主题同步
- 排查与主题相关的样式问题
- 查找特定 UI 元素的主题键
组件概览
Syncfusion 的主题系统通过 SyncfusionThemeResourceDictionary 提供统一的方式来设置所有 MAUI 组件的样式。这种集中式方案具有以下优势:
- 自动合并:自动包含控件专属样式
- 外观一致:所有组件的外观统一
- 轻松切换主题:在运行时更改主题
- 灵活自定义:覆盖特定键或创建自定义主题
- 平台主题:支持 Material Design
可用主题:
MaterialLight- Material Design 浅色主题MaterialDark- Material Design 深色主题
文档和导航指南
基本主题设置
📄 阅读: references/applying-themes.md
- 安装和配置 SyncfusionThemeResourceDictionary
- 可用主题选项(Material)
- 在 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}
- 按类别列出的常见控件键
- 查找任何控件的键
- 官方文档参考
评论
支持 Markdown