Adonis UI 开源项目教程
项目介绍
Adonis UI 是一个轻量级的 WPF 应用程序 UI 工具包,提供经典的增强型 Windows 视觉效果。它是一个开源的 UI 库,为 WPF 应用程序提供样式和模板,旨在与 WPF 内置样式相似,但带来更一致、现代的外观。
主要特性
- 增强的默认 WPF 控件
- 30+ 样式
- 亮色和暗色主题
- 光标聚光灯悬停效果
- 涟漪效果
- 数据验证支持
- 方便的 UI 开发
- 可重用和可配置的颜色
- 可自定义的窗口标题栏
- 分层系统和空间系统
项目快速启动
安装
Adonis UI 可以通过 NuGet 或手动下载安装。目前,它至少需要 .NET 4.5 或 .NET Core 3.0。
通过 NuGet 安装
Install-Package AdonisUI.ClassicTheme
配置
在您的 WPF 项目中引用 AdonisUI 和 AdonisUI.ClassicTheme。
在 App.xaml
中添加资源:
<Application xmlns:adonisUi="clr-namespace:AdonisUI;assembly=AdonisUI">
<Application.Resources>
<ResourceDictionary>
<ResourceDictionary.MergedDictionaries>
<ResourceDictionary Source="pack://application:,,,/AdonisUI;component/ColorSchemes/Light.xaml"/>
<ResourceDictionary Source="pack://application:,,,/AdonisUI.ClassicTheme;component/Resources.xaml"/>
</ResourceDictionary.MergedDictionaries>
</ResourceDictionary>
</Application.Resources>
</Application>
从 Adonis UI 的默认样式派生窗口样式:
<Window Style>
<Style TargetType="Window" BasedOn="{StaticResource {x:Type Window}}"/>
</Window Style>
应用案例和最佳实践
切换颜色方案
Adonis UI 支持在运行时切换颜色方案。您可以通过交换 Light.xaml
和 Dark.xaml
来实现这一点。
<ResourceDictionary Source="pack://application:,,,/AdonisUI;component/ColorSchemes/Dark.xaml"/>
自定义窗口标题栏
Adonis UI 允许您自定义窗口标题栏,以更好地适应您的应用程序设计。
<Window Style>
<Style TargetType="Window" BasedOn="{StaticResource {x:Type Window}}">
<Setter Property="WindowChrome.WindowChrome">
<Setter.Value>
<WindowChrome CaptionHeight="32"/>
</Setter.Value>
</Setter>
</Style>
</Window Style>
典型生态项目
Adonis UI 是一个独立的 UI 工具包,但它可以与其他 WPF 项目和库结合使用,例如:
- MaterialDesignInXamlToolkit: 结合 Material Design 和 Adonis UI 的样式。
- MahApps.Metro: 结合 Metro 风格和 Adonis UI 的增强控件。
通过这些组合,您可以创建具有独特视觉效果和用户体验的 WPF 应用程序。