Material.Icons 项目使用教程

Material.Icons 项目使用教程

Material.Icons Strongly typed parsed icons set from materialdesignicons.com and display control implementations for different GUI frameworks. 项目地址: https://gitcode.com/gh_mirrors/ma/Material.Icons

1. 项目介绍

Material.Icons 是一个开源项目，提供了从 materialdesignicons.com 解析的强类型图标集，并实现了适用于不同 GUI 框架的显示控件。该项目的主要特点包括：

• 自动更新：图标集每 6 小时自动更新，确保图标始终保持最新。
• 小包体积：图标通过 SVG Path 图形编码，减少了包的大小。
• 强类型枚举：图标类型使用强类型枚举，IDE 可以自动提示可用图标。

该项目支持多种 GUI 框架，包括 AvaloniaUI、WPF 和 WinUI/UNO。

2. 项目快速启动

2.1 安装 Material.Icons 包

首先，你需要安装 Material.Icons 的 NuGet 包。以下是安装命令：

dotnet add package Material.Icons

2.2 在 AvaloniaUI 中使用

2.2.1 安装 Avalonia 包

dotnet add package Material.Icons.Avalonia

2.2.2 在 App.xaml 中包含样式

<Application xmlns:materialIcons="clr-namespace:Material.Icons.Avalonia;assembly=Material.Icons.Avalonia">
    <Application.Styles>
        <materialIcons:MaterialIconStyles />
    </Application.Styles>
</Application>

2.2.3 使用 MaterialIcon 控件

在你的 XAML 文件中添加命名空间：

xmlns:materialIcons="clr-namespace:Material.Icons.Avalonia;assembly=Material.Icons.Avalonia"

然后使用 MaterialIcon 控件：

<materialIcons:MaterialIcon Kind="Abacus" />

2.3 在 WPF 中使用

2.3.1 安装 WPF 包

dotnet add package Material.Icons.WPF

2.3.2 使用 MaterialIcon 控件

在你的 XAML 文件中添加命名空间：

xmlns:materialIcons="clr-namespace:Material.Icons.WPF;assembly=Material.Icons.WPF"

然后使用 MaterialIcon 控件：

<materialIcons:MaterialIcon Kind="Abacus" />

3. 应用案例和最佳实践

3.1 自定义图标颜色

你可以通过设置 Foreground 属性来改变图标的颜色：

<materialIcons:MaterialIcon Kind="Abacus" Foreground="Red" />

3.2 改变图标大小

如果你使用的是 MaterialIcon 控件，可以通过 Width 和 Height 属性来调整图标大小：

<materialIcons:MaterialIcon Kind="Abacus" Width="32" Height="32" />

如果你使用的是 MaterialIconExt，可以通过 Size 属性来调整图标大小：

<Button Content="[materialIcons:MaterialIconExt Kind=Abacus Size=32]" />

4. 典型生态项目

Material.Icons 项目与以下生态项目紧密结合：

• AvaloniaUI：一个跨平台的 .NET UI 框架，Material.Icons 提供了专门的 Avalonia 控件。
• WPF：Windows Presentation Foundation，Material.Icons 提供了适用于 WPF 的控件。
• WinUI/UNO：Material.Icons 提供了适用于 WinUI 和 UNO 的控件，但这些控件存储在单独的仓库中。

通过这些生态项目的支持，Material.Icons 能够为不同平台的开发者提供一致的图标体验。

Material.Icons Strongly typed parsed icons set from materialdesignicons.com and display control implementations for different GUI frameworks. 项目地址: https://gitcode.com/gh_mirrors/ma/Material.Icons