Icons.Avalonia - GitLite

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #android #deep-learning #docker #windows #awesome #kubernetes #awesome-list #vue #pytorch #mcp

Icons.Avalonia

(★ 431)

No description available.

File Explorer

Download Latest Version (.zip)

Showing a partial file list — download the zip above to see everything.

- - call-release-please.yml
  - call-test.yml
  - push.yml
  - sync-fontawesome.yml
  - sync-materialdesign.yml
- dependabot.yml
- settings.json
- config.json
- manifest.json
- demo.png
- - App.axaml
  - App.axaml.cs
  - Demo.csproj
  - DemoViewModel.cs
  - MainWindow.axaml
  - MainWindow.axaml.cs
  - Program.cs
- - FontAwesomeFreeUtf8JsonStreamProvider.cs
  - FontAwesomeIconKey.cs
  - FontAwesomeIconKey.Legacy.cs
  - FontAwesomeIconProvider.cs
  - FontAwesomeIconsJsonContext.cs
  - IFontAwesomeUtf8JsonStreamProvider.cs
  - Projektanker.Icons.Avalonia.FontAwesome.csproj
- - FontAwesomeIconProviderTest.cs
  - icons.json
  - Projektanker.Icons.Avalonia.FontAwesome.Test.csproj
- - MaterialDesignIconProviderTest.cs
  - Projektanker.Icons.Avalonia.MaterialDesign.Test.csproj
- Directory.Build.props
.editorconfig
.gitignore
CHANGELOG.md
global.json
LICENSE
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Icons.Avalonia

A library to easily display icons in an Avalonia App.

[![🚀 Push](https://github.com/Projektanker/Icons.Avalonia/actions/workflows/push.yml/badge.svg)](https://github.com/Projektanker/Icons.Avalonia/actions/workflows/push.yml)
[![🔄 Sync Fontawesome](https://github.com/Projektanker/Icons.Avalonia/actions/workflows/sync-fontawesome.yml/badge.svg)](https://github.com/Projektanker/Icons.Avalonia/actions/workflows/sync-fontawesome.yml)
[![🔄 Sync Material Design](https://github.com/Projektanker/Icons.Avalonia/actions/workflows/sync-materialdesign.yml/badge.svg)](https://github.com/Projektanker/Icons.Avalonia/actions/workflows/sync-materialdesign.yml)

## NuGet

| Name                                                                                                                     | Description                                                     | Version                                                                         |
| :----------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------- | :------------------------------------------------------------------------------ |
| [Projektanker.Icons.Avalonia](https://www.nuget.org/packages/Projektanker.Icons.Avalonia/)                               | Core library                                                    | ![Nuget](https://badgen.net/nuget/v/Projektanker.Icons.Avalonia)                |
| [Projektanker.Icons.Avalonia.FontAwesome](https://www.nuget.org/packages/Projektanker.Icons.Avalonia.FontAwesome/)       | [Font Awesome 6 Free](https://fontawesome.com)                  | ![Nuget](https://badgen.net/nuget/v/Projektanker.Icons.Avalonia.FontAwesome)    |
| [Projektanker.Icons.Avalonia.MaterialDesign](https://www.nuget.org/packages/Projektanker.Icons.Avalonia.MaterialDesign/) | [Material Design Icons](https://pictogrammers.com/library/mdi/) | ![Nuget](https://badgen.net/nuget/v/Projektanker.Icons.Avalonia.MaterialDesign) |

## Icon providers

| Name           | Prefix | Example      |
| :------------- | :----: | :----------- |
| FontAwesome 6  |  `fa`  | `fa-github`  |
| MaterialDesign | `mdi`  | `mdi-github` |

## Usage

A full example is available in the [Demo project](src/Demo/Demo.csproj).

### 1. Register icon providers on app start up

Register the icon provider(s) with the `IconProvider.Current`.

```csharp
class Program
{
    // Initialization code. Don't use any Avalonia, third-party APIs or any
    // SynchronizationContext-reliant code before AppMain is called: things aren't initialized
    // yet and stuff might break.
    public static void Main(string[] args)
    {
        BuildAvaloniaApp()
            .StartWithClassicDesktopLifetime(args);
    }

// Avalonia configuration, don't remove; also used by visual designer.
    public static AppBuilder BuildAvaloniaApp()
    {
        IconProvider.Current
            .Register<FontAwesomeIconProvider>()
            .Register<MaterialDesignIconProvider>();

return AppBuilder.Configure<App>()
            .UsePlatformDetect()
            .LogToTrace();
    }
}
```

### 2. Add xml namespace

Add `xmlns:i="https://github.com/projektanker/icons.avalonia"` to your view.

### 3. Use the icon

**Standalone**

```xml
<i:Icon Value="fa-brands fa-anchor" />
```

**Attached to ContentControl (e.g. Button)**

```xml
<Button i:Attached.Icon="fa-brands fa-anchor" />
```

**Attached to MenuItem**

```xml
<MenuItem Header="About" i:MenuItem.Icon="fa-solid fa-circle-info" />
```

**Custom icon size**

```xml
<i:Icon Value="fa-brands fa-anchor" FontSize="24" />
```

**Animated**

```xml
<i:Icon Value="fa-spinner" Animation="Pulse" />
<i:Icon Value="fa-sync" Animation="Spin" />
```

**As an [Image](https://docs.avaloniaui.net/docs/reference/controls/image) source**

```xml
<Image>
  <Image.Source>
    <i:IconImage Value="fa-brands fa-anchor" Brush="(defaults to black)" />
  </Image.Source>
</Image>
```

### Done

![Screenshot](https://raw.githubusercontent.com/Projektanker/Icons.Avalonia/main/resources/demo.png)

## Implement your own Icon Provider

Just implement the `IIconProvider` interface:

```csharp
namespace Projektanker.Icons.Avalonia
{
    /// <summary>
    /// Represents an icon reader.
    /// </summary>
    public interface IIconReader
    {
        /// <summary>
        /// Gets the model of the requested icon.
        /// </summary>
        /// <param name="value">The value specifying the icon to return it's model from.</param>
        /// <returns>The model of the icon.</returns>
        /// <exception cref="System.Collections.Generic.KeyNotFoundException">
        /// The icon associated with the specified <paramref name="value"/> does not exists.
        /// </exception>
        IconModel GetIcon(string value);
    }

/// <summary>
    /// Represents an icon provider.
    /// </summary>
    public interface IIconProvider : IIconReader
    {
        /// <summary>
        /// Gets the prefix of the <see cref="IIconProvider"/>.
        /// </summary>
        string Prefix { get; }
    }
}
```

and register it with the `IIconProviderContainer`:

```csharp
IconProvider.Current.Register<MyCustomIconProvider>()
```

or

```csharp
IIconProvider provider = new MyCustomIconProvider(/* custom ctor arguments */);
IconProvider.Current.Register(provider);
```

The `IIconProvider.Prefix` property has to be unique within all registered providers. It is used to select the right provider. E.g. `FontAwesomeIconProvider`'s prefix is `fa`.