Fluent.Icons 0.1.0-alpha

Fluent System Icons for UWP

A UWP library that provides easy access to Microsoft's Fluent System Icons

Installation

From NuGet

In your app project, install the Fluent.Icons NuGet package. (Note that it is currently a prerelease build, so if you are searching for it in the NuGet Package Manager, make sure you have "Include prerelease" checked.) You can install the latest version using the following command in the NuGet Package Manager:

Install-Package Fluent.Icons

Build a package

1. Build the solution in Release mode and Any CPU
2. Open Command Prompt in the solution directory and run nuget pack Fluent.Icons/Fluent.Icons.csproj -properties Configuration=Release
3. Go to the Package Manager Console and set the default project to FluentSystemTestApp. Then run Install-Package "{repo_path}\FluentSystemIconsUWP\Fluent.Icons.{version}.nupkg" (change {repo_path} to where the solution folder is and {version} to the package version).
4. Test the package by deploying FluentSystemTestApp.proj

Build from source

1. Clone the repo
2. Add a reference to Fluent.Icons.csproj. You don't need the other two projects to build it.
3. Add xmlns:fluent="using:Fluent.Icons" to your pages.

Examples

The following examples assume that you have imported the Fluent.Icons namespace as follows.

xmlns:fluent="using:Fluent.Icons"

using Fluent.Icons;

Example A

Use a Fluent Icon as a button's content.

<Button>
    <fluent:FluentSymbolIcon Symbol="AddCircle"/>
</Button>

myButton.Content = new FluentSymbolIcon(FluentSymbol.AddCircle);

Example B

Use Fluent Icons in a NavigationView's MenuItems.

<NavigationView.MenuItems>
    <NavigationViewItem Content="Navigate">
        <NavigationViewItem.Icon>
            <IconSourceElement>
                <FluentIconSource Symbol="Directions" />
            </IconSourceElement>
        </NavigationViewItem.Icon>
    </NavigationViewItem>
</NavigationView.MenuItems>

myNavView.MenuItems.Add(new NavigationViewItem()
{
    Icon = new IconSourceElement()
    {
        IconSource = new FluentIconSource(FluentSymbol.Directions)
    }
});

Example C

Use a Fluent Icon in an AppBarButton.

<AppBarButton>
    <AppBarButton.Icon>
        <IconSourceElement>
            <FluentIconSource Symbol="Favorites" />
        </IconSourceElement>
    </AppBarButton.Icon>
</AppBarButton>

myAppBarButton.Icon = new IconSourceElement()
{
    IconSource = new FluentIconSource(FluentSymbol.Directions)
};

Example D

Show a list of all available Fluent Icons.

<ListView ItemsSource="{x:Bind fluent:FluentSymbolIcon.AllFluentIcons.Values}">
    <ListView.ItemTemplate>
        <DataTemplate x:DataType="x:String">
            <ListViewItem>
                <PathIcon Data="{x:Bind}" />
            </ListViewItem>
        </DataTemplate>
    </ListView.ItemTemplate>
</ListView>

Example E

Get the Windows.UI.Xaml.Media.Geometry object that represents an icon

FluentSymbolIcon.GetPathData(FluentSymbol.Home);

Example F

Get a PathIcon object that represents an icon

FluentSymbolIcon.GetPathIcon(FluentSymbol.Home);

Example G

Get the raw SVG path data for a given icon

FluentSymbolIcon.AllFluentIcons[FluentSymbol.Home];