IceTea.Avalonia.Core 1.1.4

IceTea.Avalonia.Core (Avalonia UI 核心组件库)

简介

IceTea.Avalonia.Core 是专为 Avalonia UI 框架设计的核心组件库，提供了丰富的附加属性、转换器、样式资源和实用工具。该库旨在简化 Avalonia 应用开发，提供一致的 UI 体验和高效的开发模式。

安装

dotnet add package IceTea.Avalonia.Core

核心功能模块

一、附加属性系统

MyAttachProperty - 自定义附加属性集合

提供一系列常用的附加属性，用于增强 Avalonia 控件的功能。

按钮相关附加属性：

• IsIconButton - 图标按钮样式
• IsTransparentButton - 透明按钮样式
• IsNormalButton - 普通按钮样式

使用方式：

<Button Content="图标按钮" 
        local:MyAttachProperty.IsIconButton="True" />

<Button Content="透明按钮"
        local:MyAttachProperty.IsTransparentButton="True" />

<Button Content="普通按钮" 
        local:MyAttachProperty.IsNormalButton="True" />

ButtonAttachProperty - 按钮专用附加属性 提供更多按钮相关的附加属性配置。

二、值转换器

1. OppositeBoolConverter - 布尔值反转转换器

将布尔值进行逻辑取反操作。

使用示例：

<TextBlock Text="{Binding IsVisible, 
                  Converter={StaticResource OppositeBoolConverter}}" />


var converter = new OppositeBoolConverter();
bool result = (bool)converter.Convert(true, typeof(bool), null, CultureInfo.CurrentCulture);
// result = false

2. String2KeyGestureConverter - 字符串到键盘手势转换器

将字符串转换为 Avalonia 的 KeyGesture 对象。

使用示例：

<MenuItem Header="新建" 
          InputGesture="{Binding NewCommandGesture, 
                       Converter={StaticResource String2KeyGestureConverter}}" />

三、事件系统

DialogMessageEvent - 对话框消息事件

用于在应用程序中传递对话框相关的消息事件。

四、资源字典

样式资源

提供预定义的样式和主题资源：

主要资源文件：

• All.axaml - 所有资源的聚合
• AllStyle.axaml - 所有样式定义
• CommonConverters.axaml - 通用转换器资源
• CustomColors.axaml - 自定义颜色定义

样式目录：

• Styles/ - 各种控件样式定义
• Dictionaries/ - 资源字典集合

使用方式：

<Application.Styles>
    <StyleInclude Source="avares://IceTea.Avalonia.Core/Resources/All.axaml"/>
</Application.Styles>

五、配置工具

Configs目录 - 配置管理工具

提供 Avalonia 应用的配置管理功能。

六、热键工具

HotKey目录 - 热键管理工具

提供全局热键和快捷键管理功能。

使用指南

1. 应用程序级资源引入

在 App.axaml 中引入所有核心资源：

<Application xmlns="https://github.com/avaloniaui"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
    <Application.Styles>
        <StyleInclude Source="avares://IceTea.Avalonia.Core/Resources/All.axaml"/>
    </Application.Styles>
</Application>

2. 窗口级样式应用

在特定窗口中应用样式：

<Window xmlns="https://github.com/avaloniaui"
        xmlns:local="clr-namespace:IceTea.Avalonia.Core.Attaches">
    <Window.Styles>
        <StyleInclude Source="avares://IceTea.Avalonia.Core/Resources/AllStyle.axaml"/>
    </Window.Styles>
    
    
    <Button Content="特殊按钮"
            local:MyAttachProperty.IsIconButton="True"/>
</Window>

3. 转换器使用

在资源字典中定义转换器：

< converters:OppositeBoolConverter x:Key="OppositeBoolConverter"/>
< converters:String2KeyGestureConverter x:Key="String2KeyGestureConverter"/>

然后在绑定中使用：

<TextBlock Text="{Binding IsEnabled, 
                  Converter={StaticResource OppositeBoolConverter}}"/>

核心特性

1. 一致性UI体验：提供统一的控件样式和行为
2. 可扩展性：模块化设计，易于扩展新的附加属性和转换器
3. 性能优化：高效的资源管理和绑定机制
4. 跨平台支持：完全兼容 Avalonia 的跨平台特性
5. 现代化设计：遵循现代UI设计原则

典型应用场景

1. 企业级应用：提供专业的企业应用UI组件
2. 桌面工具：快速构建功能丰富的桌面应用程序
3. 跨平台应用：一次开发，多平台部署
4. 原型开发：快速构建应用原型和演示

依赖说明

• Avalonia：核心UI框架
• Avalonia.Themes.Fluent：Fluent设计主题
• Avalonia.Diagnostics：调试工具（开发环境）

兼容性

• Avalonia: 11.0+
• .NET: 6.0+
• 平台: Windows, Linux, macOS

许可证

MIT License

作者

WuMing

贡献

欢迎提交 Issue 和 Pull Request！