CodeLifter.Iconizit 7.1.3

CodeLifter.Iconizit

A C# mapping of Font Awesome 7 Pro icons for use in MudBlazor, MAUI, or any other .NET framework that supports icon fonts.

Installation

dotnet add package CodeLifter.Iconizit

Or via NuGet Package Manager:

Install-Package CodeLifter.Iconizit

Features

• Complete Font Awesome 7 mapping - All Pro and Free icon styles and variants
• Strongly-typed icon constants - IntelliSense support and compile-time checking
• Pro and Free attributes - Easily identify which icons are available in the free tier
• Search service - Programmatically browse and filter available icons

Supported Icon Styles

Free Styles

These styles include icons available in Font Awesome Free (icons marked with [Free] attribute):

• Brands - Brand and logo icons
• Regular - Regular weight icons
• Solid - Solid weight icons

Pro Styles

These styles require a Font Awesome Pro license:

• Duotone - Two-tone solid weight icons
• DuotoneLight - Two-tone light weight icons
• DuotoneRegular - Two-tone regular weight icons
• DuotoneThin - Two-tone thin weight icons
• Light - Light weight icons
• Thin - Thin weight icons
• SharpSolid - Sharp solid icons
• SharpRegular - Sharp regular icons
• SharpLight - Sharp light icons
• SharpThin - Sharp thin icons
• SharpDuotoneSolid - Sharp two-tone solid icons
• SharpDuotoneRegular - Sharp two-tone regular icons
• SharpDuotoneLight - Sharp two-tone light icons
• SharpDuotoneThin - Sharp two-tone thin icons

Usage

Basic Usage

using Iconizit;

// Access icons via strongly-typed constants
string twitterIcon = FontAwesome.Brands.Twitter;
string checkIcon = FontAwesome.Solid.Check;
string heartIcon = FontAwesome.Regular.Heart;

With MudBlazor

@using Iconizit

<MudIcon Icon="@FontAwesome.Solid.Home" />
<MudIcon Icon="@FontAwesome.Brands.Github" />
<MudIcon Icon="@FontAwesome.Duotone.Bell" />

With MAUI

<Label FontFamily="FontAwesome.Solid" Text="{x:Static iconizit:FontAwesome.Solid.Star}" />

Using the Search Service

using Iconizit;

var searchService = new SearchService();

// Get all available icon style classes
var iconClasses = searchService.GetFontAwesomeClasses();
// Returns: ["Brands", "Duotone", "DuotoneThin", "Light", "Regular", ...]

// Get icons from a specific style with optional filtering
var icons = searchService.GetPagedFilteredIconsByClass(
    typeof(FontAwesome.Solid), 
    filter: "arrow",
    excludePro: true  // Only show free icons
);

foreach (var icon in icons)
{
    Console.WriteLine($"{icon.Name}: {icon.Value} (Pro: {icon.Pro}, Free: {icon.Free})");
}

Icon Attributes

Each icon has attributes indicating its availability:

• [Pro] - Icon is part of Font Awesome Pro
• [Free] - Icon is also available in Font Awesome Free

// Check if an icon is Pro-only at runtime
var field = typeof(FontAwesome.Solid).GetField("Check");
bool isPro = Attribute.IsDefined(field, typeof(ProAttribute));
bool isFree = Attribute.IsDefined(field, typeof(FreeAttribute));

Versioning

This library follows Font Awesome's versioning:

• Major.Minor - Tracks the Font Awesome version (e.g., 7.1.x corresponds to Font Awesome 7.1)
• Patch - Incremented for library-specific changes and fixes

Requirements

• .NET 8.0 or later
• Font Awesome 7 font files (not included - must be licensed separately from Font Awesome)

Font Setup

To use the icons, you must:

1. Obtain Font Awesome font files (Free or Pro) from Font Awesome
2. Include the appropriate OTF/TTF files in your project
3. Register the fonts in your application (varies by framework)

License

This library is licensed under the MIT License. See LICENSE for details.

Note: Font Awesome fonts and icons are subject to their own license. Please review the Font Awesome License for usage terms.

Links

• NuGet Package
• Font Awesome