FluentIcons.Common 1.3.316

FluentIcons

A multi-framework control library of fluentui-system-icons. Browse the icons in the online gallery.

Packages

This branch is for version 1.3, a backports release for legacy platforms which are no longer supported by version 2.0. Starting in version 2.0, the underlying fonts have also been migrated from TTF to CFF.

Package	Platform
FluentIcons.Avalonia	Avalonia 0.10
FluentIcons.Avalonia.Fluent	FluentAvalonia 1.3 (Avalonia 0.10)
FluentIcons.Maui	MAUI 8
FluentIcons.Uwp	Uno.UI 5.0
FluentIcons.WinUI	Uno.WinUI 5.0
FluentIcons.WinUI	Windows App SDK 1.2

Usage

<Window xmlns:ic="using:FluentIcons.WinUI">

    <ic:FluentIcon Icon="ArrowLeft" IconVariant="Regular" IconSize="Size32" />
    <ic:SymbolIcon Symbol="Calendar" IconVariant="Color" />
</Window>

This package features <FluentIcon>/<SymbolIcon> element, and <FluentIconSource>/<SymbolIconSource> on platforms with <IconSource>, which generally provide following properties:

• Icon (Fluent...) / Symbol (Symbol...) : Icon / Symbol
• IconVariant : IconVariant
  • New in version 1.1.278: Color variant added along with COLRv1 migration.
• IconSize (Fluent...) : IconSize
• FlowDirection : FlowDirection
  • Switch between LTR/RTL icon variant.
• FontSize : double
• Foreground : Brush

The Fluent variant provides all sizes of icons untouched compared to upstream, while the Symbol variant mimics the APIs and appearances of SymbolIcon and Segoe Fluent Icons from WinUI, which is powered by a derived version from the child project Seagull Icons. These variants were controlled by the deprecated UseSegoeMetrics property in distributions prior to 1.1.278.

<Window xmlns:icx="using:FluentIcons.WinUI.Markup">
    <Expander Header="{icx:SymbolIcon Symbol=ArrowLeft}" />
</Window>

Markup extension classes have been added since version 1.1.242. These extensions will bind their FlowDirection to that of the parent control, except FluentIconSourceExtension/SymbolIconSourceExtension on (non-Uno) UWP where IXamlServiceProvider is not available. They are moved to a child namespace since version.

MAUI

⚠️ The extension method UseFluentIcons(this MauiAppBuilder builder) must be called to register fonts properly.

<SymbolImageSource> and SymbolImageSourceExtension are provided on MAUI as stand-ins.

Known issues

Color icons are broken on WPF, because of the lack of COLR rendering support. It is also not working in environments like macOS and WebAssembly when rendering with SkiaSharp 2, possibly affecting Avalonia and Uno.