mcpField
S
syncfusion-maui-toolkit-theming

syncfusion-maui-toolkit-theming

github.com/syncfusion设计与 UI3943 次安装7 周前更新
代码仓库

关于 syncfusion-maui-toolkit-theming

面向 Syncfusion .NET MAUI 应用开发者的主题设置与定制指南,涵盖内置 Material 主题、运行时切换、样式覆盖和自定义主题创建。也介绍系统主题同步与主题键查找。

主要功能

  1. 01配置统一主题资源字典
  2. 02应用 Material 浅色与深色主题
  3. 03运行时切换并同步系统主题
  4. 04覆盖控件样式与颜色键
  5. 05创建自定义主题并查找主题键

适用场景

  1. 01为应用应用浅色或深色主题
  2. 02根据用户偏好动态切换主题
  3. 03统一组件外观并设置品牌样式
  4. 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.md
creating-custom-themes.md
overriding-themes.md
theme-keys-reference.md
theme-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