SuperAPI AI 工具集

avalonia-pro-max/themes

设计与创作

查看项目

更新于 11-03 16:15

技能介绍

本技能用于在为 Avalonia 应用选择或配置主题库时提供参考,覆盖 FluentTheme、FluentAvalonia、SukiUI、Semi.Avalonia、Material.Avalonia、ShadUI、Ursa.Avalonia、Citrus.Avalonia 以及 Classic、Pipboy 等主题。

用途与选型:资料给出按需求的默认选择,例如需要现代微软或 Windows 原生观感时用 FluentTheme + FluentAvalonia;需要偏扁平、Linear 风格时用 SukiUI;需要中文设计体系的清爽外观时用 Semi.Avalonia;需要 Material Design 3 时用 Material.Avalonia;需要 shadcn/ui 风格时用 ShadUI;需要丰富企业控件时用 Ursa.Avalonia;只需小幅升级内置主题时用 Citrus.Avalonia;复古 Windows 9x 用 Classic.Avalonia;主题化趣味外观用 Pipboy.Avalonia;完全自定义则只用 FluentTheme 加自建 ControlThemes。另提供按产品类型的推荐矩阵,如内部工具、管理后台与仪表盘用 FluentAvalonia + FluentTheme,跨平台消费应用用 SukiUI 或 Semi.Avalonia,移动优先用 Semi.Avalonia 加自定义令牌,开发者工具用 SukiUI 或 ShadUI,符合 Material 规范的产品用 Material.Avalonia,企业 B2B 多用 Ursa.Avalonia。

版本兼容:说明第三方主题独立于 Avalonia 版本,需选择与项目 Avalonia 版本匹配的包系列,不能混用 11.x 主题与 12.x 应用。资料列出各包在 Avalonia 11.3、12.0/12.1 下的版本与最低 Avalonia 要求,例如 FluentAvaloniaUI 2.5.1、3.0.0、3.1.0;SukiUI 6.1.1、7.0.1;Semi.Avalonia 11.3.22 及 12.x 多版本;Irihi.Ursa 1.15.1、2.0.0 至 2.2.0;Material.Avalonia 到 3.14.2 与 3.15.0 以后各版本;ShadUI 0.2.0、0.2.4。还提示目标框架差异(如 net8.0、net9.0、net10.0)并注明仅核对包元数据、未验证运行时行为。

使用方式:各主题给出 dotnet add package 安装命令与 Application.Styles 中的 XAML 引入示例,如 FluentTheme 直接引入并可通过 SystemAccentColor 等资源键定制强调色;FluentAvalonia 使用 FluentAvaloniaTheme 并列出 NavigationView、InfoBar、TeachingTip 等控件;SukiUI 使用 SukiTheme 与 SukiWindow 实现无边框标题栏,对话框通过 ISukiDialogManager 注入;Semi.Avalonia 使用 SemiTheme,可搭配 Ursa 与 Irihi.Ursa.Themes.Semi;Material.Avalonia 使用 MaterialTheme 并配合 Material.Icons.Avalonia 图标;Ursa 需基础主题再加 UrsaTheme;Citrus.Avalonia 通过 StyleInclude 引入。

组合规则与流程:列出允许的组合,如 FluentTheme + Ursa、Semi + Ursa、任意主题 + Citrus 或图标库;禁止的组合,如 Material 与 FluentAvalonia、SukiUI 与 Material 同时使用,或同一视图混用两套图标。选型流程建议先确定产品类型,安装最少 NuGet 包,设置 RequestedThemeVariant="Default",仅通过主题字典覆盖强调色与中性色,应用专属样式放在自有路径而非修改主题包,并测试明暗两种变体。

常见错误:包括导入两个基础主题导致画刷冲突、在视图中硬编码主题画刷、忘记设置 RequestedThemeVariant 导致不跟随系统、使用 SukiUI/Semi 时在 App.axaml 重写默认控件样式、未核对版本就复制画刷键、未用 SukiWindow 包裹普通 Window 导致标题栏仍是原生样式。

限制:资料仅核对包元数据,未验证各主题在 Avalonia 12 上的运行时表现;未提供部分包的安装细节(如 ShadUI 需查阅仓库),也未涉及收费、平台支持或效果保证等信息。